agent-orcha 0.0.4 → 0.0.7

package/dist/lib/sandbox/cdp-client.d.ts

@@ -0,0 +1,14 @@
+export declare class CDPClient {
+    private ws;
+    private msgId;
+    private pending;
+    private eventListeners;
+    connect(cdpUrl: string): Promise<void>;
+    private connectWs;
+    send(method: string, params?: object): Promise<any>;
+    on(event: string, handler: (params: unknown) => void): () => void;
+    once(event: string): Promise<unknown>;
+    get connected(): boolean;
+    close(): Promise<void>;
+}
+//# sourceMappingURL=cdp-client.d.ts.map

package/dist/lib/sandbox/cdp-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cdp-client.d.ts","sourceRoot":"","sources":["../../../lib/sandbox/cdp-client.ts"],"names":[],"mappings":"AAOA,qBAAa,SAAS;IACpB,OAAO,CAAC,EAAE,CAA0B;IACpC,OAAO,CAAC,KAAK,CAAK;IAClB,OAAO,CAAC,OAAO,CAGV;IACL,OAAO,CAAC,cAAc,CAAoD;IAEpE,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAgB5C,OAAO,CAAC,SAAS;IAiDX,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC;IAYzD,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,IAAI,GAAG,MAAM,IAAI;IAUjE,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAarC,IAAI,SAAS,IAAI,OAAO,CAEvB;IAEK,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAQ7B"}

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

@@ -0,0 +1,113 @@
+import WebSocket from 'ws';
+export class CDPClient {
+    ws = null;
+    msgId = 0;
+    pending = new Map();
+    eventListeners = new Map();
+    async connect(cdpUrl) {
+        if (this.ws?.readyState === WebSocket.OPEN)
+            return;
+        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');
+        }
+        await this.connectWs(page.webSocketDebuggerUrl);
+    }
+    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) {
+                        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) {
+                    handler.reject(new Error('CDP connection closed'));
+                }
+                this.pending.clear();
+            });
+        });
+    }
+    async send(method, params) {
+        if (!this.ws || this.ws.readyState !== WebSocket.OPEN) {
+            throw new Error('CDP not connected');
+        }
+        const id = ++this.msgId;
+        return new Promise((resolve, reject) => {
+            this.pending.set(id, { resolve, reject });
+            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;
+    }
+    async close() {
+        if (this.ws) {
+            this.ws.close();
+            this.ws = null;
+        }
+        this.pending.clear();
+        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

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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,121 @@
+import { JSDOM } from 'jsdom';
+/** 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_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(c => walk(c, skip, interactive, images)).join('');
+    const t = kids.trim();
+    switch (el.tagName) {
+        case 'H1': return `\n# ${t}\n`;
+        case 'H2': return `\n## ${t}\n`;
+        case 'H3': return `\n### ${t}\n`;
+        case 'H4': return `\n#### ${t}\n`;
+        case 'H5': return `\n##### ${t}\n`;
+        case 'H6': return `\n###### ${t}\n`;
+        case 'P':
+        case 'DIV':
+        case 'SECTION':
+        case 'ARTICLE':
+        case 'MAIN':
+            return t ? `\n\n${t}\n` : '';
+        case 'BR': return '\n';
+        case 'STRONG':
+        case 'B': return `**${kids}**`;
+        case 'EM':
+        case 'I': return `*${kids}*`;
+        case 'A': {
+            const href = el.getAttribute('href');
+            return href && t ? `[${t}](${href})` : t;
+        }
+        case 'UL':
+        case 'OL': return `\n${kids}\n`;
+        case 'LI': return `\n- ${t}`;
+        case 'PRE': return `\n\`\`\`\n${kids}\n\`\`\`\n`;
+        case 'CODE': {
+            if (el.parentNode && el.parentNode.tagName === 'PRE')
+                return kids;
+            return `\`${kids}\``;
+        }
+        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;
+    }
+}
+/** 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 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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,12 @@
+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 { SandboxConfigSchema } from './types.ts';
+export type { SandboxConfig, ExecResult } from './types.ts';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +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,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,mBAAmB,EAAE,MAAM,YAAY,CAAC;AACjD,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC"}

package/dist/lib/sandbox/index.js

@@ -0,0 +1,10 @@
+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 { SandboxConfigSchema } from "./types.js";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +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,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,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;IAiC7B,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,235 @@
+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');
+        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

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

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

package/dist/lib/sandbox/sandbox-browser.d.ts

@@ -0,0 +1,4 @@
+import type { StructuredTool } from '../types/llm-types.ts';
+import type { SandboxConfig } from './types.ts';
+export declare function createBrowserTools(config: SandboxConfig): StructuredTool[];
+//# sourceMappingURL=sandbox-browser.d.ts.map

package/dist/lib/sandbox/sandbox-browser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sandbox-browser.d.ts","sourceRoot":"","sources":["../../../lib/sandbox/sandbox-browser.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,cAAc,EAAe,MAAM,uBAAuB,CAAC;AACzE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAKhD,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,aAAa,GAAG,cAAc,EAAE,CAqW1E"}