@agent-browser-io/browser 0.1.0 → 0.2.0

package/dist/esm/ai-sdk/createBrowserTools.js

@@ -0,0 +1,189 @@
+/**
+ * Vercel AI SDK tools for agent-browser-io.
+ * Use with generateText({ tools: createBrowserTools(browser), ... }).
+ * Call the launch tool before other actions if the browser is not yet running.
+ */
+import { tool } from "ai";
+import { z } from "zod";
+function wrapExecute(browser, fn) {
+    return async (args) => {
+        try {
+            return await fn(browser, args);
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            return `Error: ${message}`;
+        }
+    };
+}
+/**
+ * Creates a set of Vercel AI SDK–compatible tools that control the given browser instance.
+ * Pass the result to generateText({ tools: createBrowserTools(browser), ... }).
+ * The model should call the launch tool first before other actions.
+ */
+export function createBrowserTools(browser) {
+    return {
+        launch: tool({
+            description: "Launch the browser (idempotent). Call before other actions if the browser is not yet running.",
+            inputSchema: z.object({}),
+            execute: wrapExecute(browser, async (b) => {
+                await b.launch();
+                return "Browser launched.";
+            }),
+        }),
+        navigate: tool({
+            description: "Navigate to a URL and apply the wireframe normalizer.",
+            inputSchema: z.object({
+                url: z.string().describe("URL to open"),
+            }),
+            execute: wrapExecute(browser, async (b, { url }) => {
+                await b.navigate(url);
+                return `Navigated to ${url}`;
+            }),
+        }),
+        getWireframe: tool({
+            description: "Return the ASCII wireframe of the current page. Use ref IDs from this output for click, type, fill, etc. Ref ids are positioned at the start of the element.",
+            inputSchema: z.object({}),
+            execute: wrapExecute(browser, async (b) => {
+                const wireframe = await b.getWireframe();
+                return wireframe || "(empty wireframe)";
+            }),
+        }),
+        click: tool({
+            description: "Click the element with the given ref ID (from the wireframe).",
+            inputSchema: z.object({
+                ref: z.string().describe("Element ref ID from wireframe"),
+            }),
+            execute: wrapExecute(browser, async (b, { ref }) => {
+                await b.click(ref);
+                return `Clicked ref ${ref}`;
+            }),
+        }),
+        type: tool({
+            description: "Type text into the element with the given ref ID.",
+            inputSchema: z.object({
+                ref: z.string().describe("Element ref ID from wireframe"),
+                text: z.string().describe("Text to type"),
+            }),
+            execute: wrapExecute(browser, async (b, { ref, text }) => {
+                await b.type(ref, text);
+                return `Typed into ref ${ref}`;
+            }),
+        }),
+        fill: tool({
+            description: "Clear and fill the element (by ref) with the given text.",
+            inputSchema: z.object({
+                ref: z.string().describe("Element ref ID from wireframe"),
+                text: z.string().describe("Text to fill"),
+            }),
+            execute: wrapExecute(browser, async (b, { ref, text }) => {
+                await b.fill(ref, text);
+                return `Filled ref ${ref}`;
+            }),
+        }),
+        dblclick: tool({
+            description: "Double-click the element with the given ref ID.",
+            inputSchema: z.object({
+                ref: z.string().describe("Element ref ID from wireframe"),
+            }),
+            execute: wrapExecute(browser, async (b, { ref }) => {
+                await b.dblclick(ref);
+                return `Double-clicked ref ${ref}`;
+            }),
+        }),
+        hover: tool({
+            description: "Hover over the element with the given ref ID.",
+            inputSchema: z.object({
+                ref: z.string().describe("Element ref ID from wireframe"),
+            }),
+            execute: wrapExecute(browser, async (b, { ref }) => {
+                await b.hover(ref);
+                return `Hovered ref ${ref}`;
+            }),
+        }),
+        press: tool({
+            description: "Press a keyboard key (e.g. Enter, Tab, ArrowDown).",
+            inputSchema: z.object({
+                key: z.string().describe("Key to press"),
+            }),
+            execute: wrapExecute(browser, async (b, { key }) => {
+                await b.press(key);
+                return `Pressed key ${key}`;
+            }),
+        }),
+        select: tool({
+            description: "Select an option in a dropdown by ref and value.",
+            inputSchema: z.object({
+                ref: z.string().describe("Element ref ID from wireframe"),
+                value: z.string().describe("Option value to select"),
+            }),
+            execute: wrapExecute(browser, async (b, { ref, value }) => {
+                await b.select(ref, value);
+                return `Selected value in ref ${ref}`;
+            }),
+        }),
+        check: tool({
+            description: "Check the checkbox/radio with the given ref ID.",
+            inputSchema: z.object({
+                ref: z.string().describe("Element ref ID from wireframe"),
+            }),
+            execute: wrapExecute(browser, async (b, { ref }) => {
+                await b.check(ref);
+                return `Checked ref ${ref}`;
+            }),
+        }),
+        uncheck: tool({
+            description: "Uncheck the checkbox with the given ref ID.",
+            inputSchema: z.object({
+                ref: z.string().describe("Element ref ID from wireframe"),
+            }),
+            execute: wrapExecute(browser, async (b, { ref }) => {
+                await b.uncheck(ref);
+                return `Unchecked ref ${ref}`;
+            }),
+        }),
+        scroll: tool({
+            description: "Scroll the page in the given direction.",
+            inputSchema: z.object({
+                direction: z
+                    .enum(["up", "down", "left", "right"])
+                    .describe("Scroll direction"),
+                pixels: z.number().optional().describe("Pixels to scroll (default 100)"),
+            }),
+            execute: wrapExecute(browser, async (b, { direction, pixels }) => {
+                await b.scroll(direction, pixels);
+                return `Scrolled ${direction}`;
+            }),
+        }),
+        screenshot: tool({
+            description: "Take a screenshot. Returns base64 PNG when path is omitted; otherwise saves to file.",
+            inputSchema: z.object({
+                path: z
+                    .string()
+                    .optional()
+                    .describe("Optional file path to save screenshot"),
+                fullPage: z
+                    .boolean()
+                    .optional()
+                    .describe("Capture full scrollable page"),
+            }),
+            execute: wrapExecute(browser, async (b, { path: filePath, fullPage }) => {
+                const result = await b.screenshot(filePath, { fullPage });
+                if (filePath) {
+                    return `Screenshot saved to ${filePath}`;
+                }
+                const base64 = result instanceof Buffer ? result.toString("base64") : "";
+                return base64 ? `data:image/png;base64,${base64}` : "(no image)";
+            }),
+        }),
+        close: tool({
+            description: "Close the browser.",
+            inputSchema: z.object({}),
+            execute: wrapExecute(browser, async (b) => {
+                await b.close();
+                return "Browser closed.";
+            }),
+        }),
+    };
+}
+//# sourceMappingURL=createBrowserTools.js.map

package/dist/esm/ai-sdk/createBrowserTools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createBrowserTools.js","sourceRoot":"","sources":["../../../src/ai-sdk/createBrowserTools.ts"],"names":[],"mappings":"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"}

package/dist/esm/cli/cli.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Interactive CLI for @agent-browser-io/browser
+ * Launches a browser and provides REPL-style commands.
+ */
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/esm/cli/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../../src/cli/cli.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/esm/cli/cli.js

@@ -0,0 +1,114 @@
+/**
+ * Interactive CLI for @agent-browser-io/browser
+ * Launches a browser and provides REPL-style commands.
+ */
+import * as readline from 'readline';
+import { VERSION } from '../index';
+import { AgentBrowser } from '../core/agent-browser/agent-browser.js';
+import { DefaultBrowserBackend } from '../core/browser-backend/index.js';
+const PROMPT = 'agent-browser> ';
+function print(msg) {
+    console.log(msg);
+}
+async function main() {
+    print(`@agent-browser-io/browser v${VERSION}`);
+    print('Launching browser...');
+    const backend = new DefaultBrowserBackend();
+    const browser = new AgentBrowser(backend);
+    await browser.launch();
+    print('Browser ready. Type "help" for commands, "exit" or Ctrl+D to quit.\n');
+    const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+    const loop = () => {
+        rl.question(PROMPT, async (line) => {
+            const trimmed = line.trim();
+            const parts = trimmed.split(/\s+/).filter(Boolean);
+            const cmd = parts[0]?.toLowerCase() ?? '';
+            const rest = parts.slice(1);
+            if (cmd === 'exit' || cmd === 'quit' || cmd === 'q') {
+                rl.close();
+                process.exit(0);
+            }
+            if (cmd === 'help') {
+                print('  help            Show this message');
+                print('  version         Show version');
+                print('  navigate <url>  Open URL and apply wireframe normalizer');
+                print('  wireframe       Print ASCII wireframe of current page');
+                print('  click <ref>     Click element by ref id (e.g. 1)');
+                print('  type <ref> <text>  Type into element by ref id');
+                print('  exit            Quit the CLI');
+            }
+            else if (cmd === 'version') {
+                print(`  ${VERSION}`);
+            }
+            else if (cmd === 'navigate') {
+                const url = rest[0];
+                if (!url) {
+                    print('  Usage: navigate <url>');
+                }
+                else {
+                    try {
+                        await browser.navigate(url);
+                        print(`  Navigated to ${url}`);
+                    }
+                    catch (e) {
+                        print(`  Error: ${e instanceof Error ? e.message : String(e)}`);
+                    }
+                }
+            }
+            else if (cmd === 'wireframe') {
+                try {
+                    const wf = await browser.getWireframe();
+                    print(wf || '  (empty wireframe)');
+                }
+                catch (e) {
+                    print(`  Error: ${e instanceof Error ? e.message : String(e)}`);
+                }
+            }
+            else if (cmd === 'click') {
+                const ref = rest[0];
+                if (!ref) {
+                    print('  Usage: click <ref>');
+                }
+                else {
+                    try {
+                        await browser.click(ref);
+                        print(`  Clicked ref ${ref}`);
+                    }
+                    catch (e) {
+                        print(`  Error: ${e instanceof Error ? e.message : String(e)}`);
+                    }
+                }
+            }
+            else if (cmd === 'type') {
+                const ref = rest[0];
+                const text = rest.slice(1).join(' ');
+                if (!ref) {
+                    print('  Usage: type <ref> <text>');
+                }
+                else {
+                    try {
+                        await browser.type(ref, text);
+                        print(`  Typed into ref ${ref}`);
+                    }
+                    catch (e) {
+                        print(`  Error: ${e instanceof Error ? e.message : String(e)}`);
+                    }
+                }
+            }
+            else if (trimmed !== '') {
+                print(`  Unknown command: ${cmd}. Type "help" for commands.`);
+            }
+            loop();
+        });
+    };
+    rl.on('close', () => {
+        print('\nBye.');
+        process.exit(0);
+    });
+    loop();
+}
+main().catch((e) => {
+    console.error('Fatal:', e);
+    process.exit(1);
+});
+//# sourceMappingURL=cli.js.map

package/dist/esm/cli/cli.js.map

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

package/dist/esm/core/agent-browser/agent-browser.d.ts

@@ -0,0 +1,51 @@
+import { IBrowserBackend } from "../browser-backend/browser-backend.js";
+export interface IAgentBrowser {
+    launch(): Promise<void>;
+    navigate(url: string): Promise<void>;
+    click(ref: string): Promise<void>;
+    type(ref: string, text: string): Promise<void>;
+    dblclick(ref: string): Promise<void>;
+    fill(ref: string, text: string): Promise<void>;
+    press(key: string): Promise<void>;
+    hover(ref: string): Promise<void>;
+    select(ref: string, value: string): Promise<void>;
+    check(ref: string): Promise<void>;
+    uncheck(ref: string): Promise<void>;
+    scroll(direction: "up" | "down" | "left" | "right", pixels?: number): Promise<void>;
+    screenshot(path?: string, options?: {
+        fullPage?: boolean;
+    }): Promise<Buffer | void>;
+    close(): Promise<void>;
+    getWireframe(): Promise<string>;
+}
+export declare class AgentBrowser implements IAgentBrowser {
+    private readonly browserBackend;
+    constructor(browserBackend: IBrowserBackend);
+    private injectNormalizeScript;
+    launch(): Promise<void>;
+    navigate(url: string): Promise<void>;
+    /** Ref is the data-ref-id value from the wireframe (e.g. "1"). */
+    click(ref: string): Promise<void>;
+    /** Ref is the data-ref-id value from the wireframe (e.g. "1"). */
+    type(ref: string, text: string): Promise<void>;
+    /** Ref is the data-ref-id value from the wireframe (e.g. "1"). */
+    dblclick(ref: string): Promise<void>;
+    /** Ref is the data-ref-id value from the wireframe (e.g. "1"). */
+    fill(ref: string, text: string): Promise<void>;
+    press(key: string): Promise<void>;
+    /** Ref is the data-ref-id value from the wireframe (e.g. "1"). */
+    hover(ref: string): Promise<void>;
+    /** Ref is the data-ref-id value from the wireframe (e.g. "1"). */
+    select(ref: string, value: string): Promise<void>;
+    /** Ref is the data-ref-id value from the wireframe (e.g. "1"). */
+    check(ref: string): Promise<void>;
+    /** Ref is the data-ref-id value from the wireframe (e.g. "1"). */
+    uncheck(ref: string): Promise<void>;
+    scroll(direction: "up" | "down" | "left" | "right", pixels?: number): Promise<void>;
+    screenshot(path?: string, options?: {
+        fullPage?: boolean;
+    }): Promise<Buffer | void>;
+    close(): Promise<void>;
+    getWireframe(): Promise<string>;
+}
+//# sourceMappingURL=agent-browser.d.ts.map

package/dist/esm/core/agent-browser/agent-browser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-browser.d.ts","sourceRoot":"","sources":["../../../../src/core/agent-browser/agent-browser.ts"],"names":[],"mappings":"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"}

package/dist/esm/core/agent-browser/agent-browser.js

@@ -0,0 +1,76 @@
+import { NORMALIZE_SCRIPT } from "./normalize-script.js";
+export class AgentBrowser {
+    constructor(browserBackend) {
+        this.browserBackend = browserBackend;
+    }
+    async injectNormalizeScript() {
+        await this.browserBackend.evaluate(NORMALIZE_SCRIPT);
+    }
+    async launch() {
+        await this.browserBackend.launch();
+    }
+    async navigate(url) {
+        await this.browserBackend.navigate(url);
+        await this.injectNormalizeScript();
+    }
+    /** Ref is the data-ref-id value from the wireframe (e.g. "1"). */
+    async click(ref) {
+        await this.browserBackend.click(`[data-ref-id="${ref}"]`);
+        await this.injectNormalizeScript();
+    }
+    /** Ref is the data-ref-id value from the wireframe (e.g. "1"). */
+    async type(ref, text) {
+        await this.browserBackend.type(`[data-ref-id="${ref}"]`, text);
+        await this.injectNormalizeScript();
+    }
+    /** Ref is the data-ref-id value from the wireframe (e.g. "1"). */
+    async dblclick(ref) {
+        await this.browserBackend.dblclick(`[data-ref-id="${ref}"]`);
+        await this.injectNormalizeScript();
+    }
+    /** Ref is the data-ref-id value from the wireframe (e.g. "1"). */
+    async fill(ref, text) {
+        await this.browserBackend.fill(`[data-ref-id="${ref}"]`, text);
+        await this.injectNormalizeScript();
+    }
+    async press(key) {
+        await this.browserBackend.press(key);
+        await this.injectNormalizeScript();
+    }
+    /** Ref is the data-ref-id value from the wireframe (e.g. "1"). */
+    async hover(ref) {
+        await this.browserBackend.hover(`[data-ref-id="${ref}"]`);
+        await this.injectNormalizeScript();
+    }
+    /** Ref is the data-ref-id value from the wireframe (e.g. "1"). */
+    async select(ref, value) {
+        await this.browserBackend.select(`[data-ref-id="${ref}"]`, value);
+        await this.injectNormalizeScript();
+    }
+    /** Ref is the data-ref-id value from the wireframe (e.g. "1"). */
+    async check(ref) {
+        await this.browserBackend.check(`[data-ref-id="${ref}"]`);
+        await this.injectNormalizeScript();
+    }
+    /** Ref is the data-ref-id value from the wireframe (e.g. "1"). */
+    async uncheck(ref) {
+        await this.browserBackend.uncheck(`[data-ref-id="${ref}"]`);
+        await this.injectNormalizeScript();
+    }
+    async scroll(direction, pixels) {
+        await this.browserBackend.scroll(direction, pixels);
+        await this.injectNormalizeScript();
+    }
+    async screenshot(path, options) {
+        return this.browserBackend.screenshot(path, options);
+    }
+    async close() {
+        await this.browserBackend.close();
+    }
+    async getWireframe() {
+        await this.injectNormalizeScript();
+        const result = await this.browserBackend.evaluate("typeof window.generateWireframeString === 'function' ? window.generateWireframeString() : ''");
+        return typeof result === "string" ? result : "";
+    }
+}
+//# sourceMappingURL=agent-browser.js.map

package/dist/esm/core/agent-browser/agent-browser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-browser.js","sourceRoot":"","sources":["../../../../src/core/agent-browser/agent-browser.ts"],"names":[],"mappings":"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"}

package/dist/esm/core/agent-browser/normalize-script.d.ts

@@ -0,0 +1,3 @@
+/** Injected browser script for wireframe normalization. Exported as string for evaluation in the page. */
+export declare const NORMALIZE_SCRIPT = "\n// This script is intended to be used in the browser.\n// It is not intended to be used in node.\n(function applyWireframeMode() {\n    // --- PART A: INJECT CSS STYLES (idempotent) ---\n    if (!document.getElementById(\"wf-normalize\")) {\n        const cssStyles = `\n            /* FORCE GLOBAL MONOSPACE & METRICS */\n            * {\n                font-family: \"Courier New\", Courier, monospace !important;\n                font-size: 12px !important;\n                font-weight: normal !important;\n                color: #000000 !important;\n                line-height: 18px !important;\n                letter-spacing: 0px !important;\n                box-shadow: none !important;\n                text-shadow: none !important;\n                border-radius: 0 !important;\n                transition: none !important;\n            }\n\n            /* HIGH CONTRAST THEME */\n            body {\n                background-color: #ffffff !important;\n                color: #000000 !important;\n            }\n\n            /* STRUCTURAL OUTLINES */\n            div, section, article, header, footer, nav, aside, main {\n                border: 1px dotted #cccccc !important;\n            }\n\n            /* KILL PSEUDO-ELEMENT BACKGROUNDS */\n            *::before, *::after {\n                background-image: none !important;\n                background-color: transparent !important;\n                border: none !important;\n            }\n\n            /* INTERACTIVE ELEMENTS */\n            a, button, input[type=\"submit\"], input[type=\"button\"], [role=\"button\"] {\n                border: 2px solid #000000 !important;\n                background-color: #ffffff !important;\n                color: #000000 !important;\n                text-transform: uppercase !important;\n                text-decoration: none !important;\n                font-weight: bold !important;\n            }\n\n            /* FORM INPUTS */\n            input, textarea, select {\n                border: 1px solid #000000 !important;\n                background-color: #ffffff !important;\n                color: #000000 !important;\n                font-family: monospace !important;\n            }\n\n            /* HIDE DECORATIVE MEDIA */\n            img, video, canvas, svg {\n                opacity: 0.5 !important;\n                filter: grayscale(100%) !important;\n                border: 1px dashed #000 !important;\n            }\n\n            /* BACKGROUND IMAGE INDICATORS */\n            [data-bg-image=\"true\"] {\n                background-color: #f4f4f4 !important;\n                border: 1px dashed #555555 !important;\n                position: relative !important;\n            }\n            [data-bg-image=\"true\"]::before {\n                content: \"[ BG IMAGE ]\";\n                position: absolute;\n                top: 0; right: 0;\n                background: #000000; color: #ffffff;\n                font-size: 10px !important;\n                padding: 2px 4px;\n                opacity: 0.8;\n                z-index: 9999;\n                pointer-events: none;\n                font-weight: normal !important;\n            }\n        `;\n\n        const styleSheet = document.createElement(\"style\");\n        styleSheet.id = \"wf-normalize\";\n        styleSheet.type = \"text/css\";\n        styleSheet.innerText = cssStyles;\n        document.head.appendChild(styleSheet);\n    }\n\n    // --- PART B: NORMALIZE DOM CONTENT (idempotent) ---\n    if (!document.body) return; // page not ready\n\n    // Helper: check if element is the top-most (not behind an overlay) at its center\n    function isElementVisible(el) {\n        var rect = el.getBoundingClientRect();\n        var cx = rect.left + rect.width / 2;\n        var cy = rect.top + rect.height / 2;\n        if (cx < 0 || cy < 0 || cx >= window.innerWidth || cy >= window.innerHeight) return false;\n        var topEl = document.elementFromPoint(cx, cy);\n        if (!topEl) return false;\n        return el.contains(topEl) || topEl.contains(el);\n    }\n\n    // Remove old ref IDs and reset counter\n    document.querySelectorAll(\"[data-ref-id]\").forEach(function(el) {\n        el.removeAttribute(\"data-ref-id\");\n    });\n    var refCounter = 1;\n\n    // Only run DOM mutations (media replacement, accessibility labels, bg stripping) once\n    if (!document.body.hasAttribute(\"data-wf-normalized\")) {\n        document.body.setAttribute(\"data-wf-normalized\", \"true\");\n\n        // 1. REVEAL ACCESSIBILITY LABELS (ICON BUTTONS)\n        var interactives = document.querySelectorAll('a, button, [role=\"button\"]');\n        interactives.forEach(function(el) {\n            if (el.innerText.trim() === '') {\n                var label = el.getAttribute('aria-label') || el.getAttribute('title');\n                // Also check child elements for hints (e.g. HN vote arrows: <a><div title=\"upvote\"></a>)\n                if (!label) {\n                    var hintEl = el.querySelector('[aria-label], [title]');\n                    if (hintEl) label = hintEl.getAttribute('aria-label') || hintEl.getAttribute('title');\n                }\n                if (label) {\n                    el.innerText = label;\n                    el.style.display = 'inline-block';\n                    el.style.width = 'auto';\n                    el.style.height = 'auto';\n                }\n            }\n        });\n\n        // 2. REPLACE MEDIA WITH INTELLIGENT PLACEHOLDERS\n        var mediaElements = document.querySelectorAll('img, svg, video, canvas');\n        mediaElements.forEach(function(el) {\n            var rect = el.getBoundingClientRect();\n            if (rect.width < 10 || rect.height < 10) return;\n\n            var placeholder = document.createElement('div');\n            placeholder.style.cssText =\n                'width:' + rect.width + 'px;' +\n                'height:' + rect.height + 'px;' +\n                'background:#f0f0f0;color:#000;font-family:monospace;font-weight:bold;' +\n                'display:flex;align-items:center;justify-content:center;text-align:center;' +\n                'overflow:hidden;box-sizing:border-box;';\n\n            var altText = el.getAttribute('alt') ||\n                          el.getAttribute('title') ||\n                          el.getAttribute('aria-label');\n\n            if (!altText && el.tagName.toLowerCase() === 'svg') {\n                var titleEl = el.querySelector('title');\n                if (titleEl) altText = titleEl.textContent;\n            }\n\n            if (rect.width <= 50 && rect.height <= 50) {\n                placeholder.style.border = '1px solid #333';\n                placeholder.style.fontSize = '8px';\n                placeholder.style.padding = '0';\n                // Use short label for tiny icons to avoid overflow\n                if (rect.width <= 20 || rect.height <= 20) {\n                    placeholder.innerText = altText ? altText.substring(0, 1) : '*';\n                } else {\n                    var iconLabel = altText ? altText.substring(0, 8) : \"ICON\";\n                    placeholder.innerText = '[' + iconLabel + ']';\n                }\n            } else {\n                placeholder.style.border = '2px solid #000';\n                placeholder.style.fontSize = '10px';\n                placeholder.style.padding = '2px';\n                placeholder.style.wordBreak = 'break-word';\n                var imgLabel = altText ? altText : \"IMAGE\";\n                placeholder.innerText = '[' + imgLabel + ']';\n            }\n\n            if (el.parentNode) {\n                el.parentNode.replaceChild(placeholder, el);\n            }\n        });\n\n        // 3. CONVERT BACKGROUND IMAGES & STRIP COLORS\n        var allElements = document.querySelectorAll('*');\n        allElements.forEach(function(el) {\n            var style = window.getComputedStyle(el);\n            var hasBgImage = style.backgroundImage !== 'none' && style.backgroundImage !== '';\n            var hasBgColor = style.backgroundColor !== 'rgba(0, 0, 0, 0)' &&\n                             style.backgroundColor !== 'transparent' &&\n                             style.backgroundColor !== 'rgb(255, 255, 255)';\n\n            if (hasBgImage) {\n                el.style.backgroundImage = 'none';\n                el.setAttribute('data-bg-image', 'true');\n            }\n\n            if (hasBgColor) {\n                el.style.backgroundColor = '#ffffff';\n            }\n        });\n    }\n\n    // 4. REMOVE TRANSPARENT OVERLAY BACKDROPS (run every time \u2014 new overlays can appear)\n    // Full-viewport high z-index divs with no meaningful text are just backdrop overlays\n    // that block elementFromPoint for content behind them\n    var overlayDivs = document.querySelectorAll('div');\n    overlayDivs.forEach(function(el) {\n        var style = window.getComputedStyle(el);\n        var z = parseInt(style.zIndex) || 0;\n        if (z < 100 || style.display === 'none') return;\n        var rect = el.getBoundingClientRect();\n        if (rect.width < window.innerWidth * 0.9 || rect.height < window.innerHeight * 0.9) return;\n        var text = (el.innerText || '').trim();\n        if (text.length < 5) {\n            el.style.display = 'none';\n        }\n    });\n\n    // Overflow buffer: capture high-z-index elements pushed below viewport by CSS normalization\n    var OVERFLOW_BUFFER = 200;\n    var captureHeight = window.innerHeight + OVERFLOW_BUFFER;\n\n    // 5. TAG INTERACTIVE ELEMENTS (always re-run since we cleared ref IDs)\n    // Only tag elements visible, in viewport (+ overflow buffer), and not behind overlays\n    function tagIfVisible(el) {\n        if (el.hasAttribute('data-ref-id')) return; // already tagged\n        var rect = el.getBoundingClientRect();\n        var style = window.getComputedStyle(el);\n        if (rect.width === 0 || rect.height === 0 || style.display === 'none' || style.visibility === 'hidden') return;\n        if (rect.bottom < 0 || rect.top >= captureHeight || rect.right < 0 || rect.left >= window.innerWidth) return;\n        // Elements in overflow zone (below viewport): can't use elementFromPoint, just tag them\n        if (rect.top >= window.innerHeight) {\n            el.setAttribute('data-ref-id', String(refCounter++));\n            return;\n        }\n        if (!isElementVisible(el)) return;\n        el.setAttribute('data-ref-id', String(refCounter++));\n    }\n\n    // Pass 1: semantic interactive elements\n    var allInteractives = document.querySelectorAll('a, button, input, textarea, select, [role=\"button\"], [onclick], [tabindex=\"0\"]');\n    allInteractives.forEach(tagIfVisible);\n\n    // Pass 2: non-semantic clickable elements (divs/spans with cursor:pointer and text)\n    // This catches sites that use <div> as buttons without proper ARIA roles\n    var potentialClickables = document.querySelectorAll('div, span');\n    potentialClickables.forEach(function(el) {\n        if (el.hasAttribute('data-ref-id')) return;\n        // Skip if already inside a tagged interactive element\n        if (el.closest && el.closest('[data-ref-id]')) return;\n        var style = window.getComputedStyle(el);\n        if (style.cursor !== 'pointer') return;\n        // Must have direct text content (not just children with text)\n        var hasDirectText = false;\n        for (var i = 0; i < el.childNodes.length; i++) {\n            if (el.childNodes[i].nodeType === 3 && el.childNodes[i].textContent.trim()) {\n                hasDirectText = true;\n                break;\n            }\n        }\n        if (!hasDirectText) return;\n        tagIfVisible(el);\n    });\n\n    console.log(\"Normalization Complete.\");\n\n    // --- PART C: WIREFRAME STRING GENERATOR ---\n    function generateWireframeString() {\n        // 1. Measure CHAR_W dynamically\n        var probe = document.createElement('span');\n        probe.style.cssText = 'font-family:\"Courier New\",Courier,monospace;font-size:12px;line-height:18px;letter-spacing:0px;position:absolute;top:-9999px;left:-9999px;white-space:pre;visibility:hidden;';\n        probe.textContent = 'MMMMMMMMMM';\n        document.body.appendChild(probe);\n        var CHAR_W = probe.getBoundingClientRect().width / 10;\n        document.body.removeChild(probe);\n        if (CHAR_W <= 0) CHAR_W = 7.2; // fallback\n\n        var CHAR_H = 18;\n\n        // 2. Create grid (includes overflow buffer for elements pushed below viewport)\n        var OVERFLOW_BUFFER_C = 200;\n        var captureHeightC = window.innerHeight + OVERFLOW_BUFFER_C;\n        var gridWidth = Math.ceil(window.innerWidth / CHAR_W);\n        var gridHeight = Math.ceil(captureHeightC / CHAR_H);\n        var grid = [];\n        for (var r = 0; r < gridHeight; r++) {\n            var row = [];\n            for (var c = 0; c < gridWidth; c++) {\n                row.push(' ');\n            }\n            grid.push(row);\n        }\n\n        function writeToGrid(x, y, str) {\n            if (y < 0 || y >= gridHeight) return;\n            for (var i = 0; i < str.length; i++) {\n                var curX = x + i;\n                if (curX >= 0 && curX < gridWidth) {\n                    grid[y][curX] = str[i];\n                }\n            }\n        }\n\n        // 3. Draw borders only for block-level interactive elements (buttons, form controls)\n        //    Skip inline links \u2014 they just get ref labels.\n        var refElements = document.querySelectorAll('[data-ref-id]');\n        refElements.forEach(function(el) {\n            var rect = el.getBoundingClientRect();\n            var style = window.getComputedStyle(el);\n            if (style.display === 'none' || style.visibility === 'hidden' || rect.width === 0 || rect.height === 0) return;\n            // Skip elements outside capture area\n            if (rect.bottom < 0 || rect.top >= captureHeightC || rect.right < 0 || rect.left >= window.innerWidth) return;\n\n            // Only draw borders for buttons, form elements, and block-level role=button\n            var tag = el.tagName;\n            var isFormEl = (tag === 'BUTTON' || tag === 'INPUT' || tag === 'TEXTAREA' || tag === 'SELECT');\n            var isBlockButton = (el.getAttribute('role') === 'button' && style.display !== 'inline');\n            if (!isFormEl && !isBlockButton) return;\n\n            var x = Math.floor(rect.left / CHAR_W);\n            var y = Math.floor(rect.top / CHAR_H);\n            var w = Math.max(2, Math.ceil(rect.width / CHAR_W));\n            var h = Math.max(2, Math.ceil(rect.height / CHAR_H));\n\n            // Top border\n            writeToGrid(x, y, '+' + repeat('-', Math.max(0, w - 2)) + '+');\n            // Side borders\n            for (var i = 1; i < h - 1; i++) {\n                writeToGrid(x, y + i, '|');\n                writeToGrid(x + w - 1, y + i, '|');\n            }\n            // Bottom border\n            if (h > 1) {\n                writeToGrid(x, y + h - 1, '+' + repeat('-', Math.max(0, w - 2)) + '+');\n            }\n        });\n\n        // Helper: check if element is the top-most at a given point\n        function isVisibleAt(el, px, py) {\n            if (px < 0 || py < 0 || px >= window.innerWidth) return false;\n            // Overflow zone: elementFromPoint doesn't work below viewport, assume visible\n            if (py >= window.innerHeight) return py < captureHeightC;\n            var topEl = document.elementFromPoint(px, py);\n            if (!topEl) return false;\n            return el.contains(topEl) || topEl.contains(el);\n        }\n\n        // 4. Render text via TreeWalker (text only, no labels yet)\n        var labeledRefs = {}; // refId -> {row, col} where the element's first text starts\n        var walker = document.createTreeWalker(document.body, NodeFilter.SHOW_TEXT, null, false);\n        var textNode;\n        while ((textNode = walker.nextNode())) {\n            var parent = textNode.parentElement;\n            if (!parent) continue;\n\n            // Skip script/style\n            var tag = parent.tagName;\n            if (tag === 'SCRIPT' || tag === 'STYLE' || tag === 'NOSCRIPT') continue;\n\n            // Skip invisible parents\n            var pStyle = window.getComputedStyle(parent);\n            if (pStyle.display === 'none' || pStyle.visibility === 'hidden' || pStyle.opacity === '0') continue;\n\n            // Skip empty text\n            var rawText = textNode.textContent;\n            if (!rawText || !rawText.trim()) continue;\n\n            // Skip form elements (handled separately)\n            if (tag === 'INPUT' || tag === 'TEXTAREA' || tag === 'SELECT' || tag === 'OPTION') continue;\n\n            // Collapse whitespace\n            var collapsed = rawText.replace(/\\s+/g, ' ').trim();\n            if (!collapsed) continue;\n\n            // Track first text position for ref label insertion\n            var refAncestor = parent.closest ? parent.closest('[data-ref-id]') : null;\n\n            // Use Range + getClientRects for accurate per-line positioning\n            var range = document.createRange();\n            range.selectNodeContents(textNode);\n            var rects = range.getClientRects();\n\n            if (rects.length === 0) continue;\n\n            var charOffset = 0;\n            var firstWritten = false;\n            for (var ri = 0; ri < rects.length; ri++) {\n                var rr = rects[ri];\n                if (rr.width < 1 || rr.height < 1) continue;\n\n                // Skip rects outside capture area or covered by overlays\n                if (rr.bottom < 0 || rr.top >= captureHeightC || rr.right < 0 || rr.left >= window.innerWidth) {\n                    charOffset += Math.max(1, Math.ceil(rr.width / CHAR_W));\n                    continue;\n                }\n                var rcx = rr.left + rr.width / 2;\n                var rcy = rr.top + rr.height / 2;\n                if (!isVisibleAt(parent, rcx, rcy)) {\n                    charOffset += Math.max(1, Math.ceil(rr.width / CHAR_W));\n                    continue;\n                }\n\n                var gx = Math.floor(rr.left / CHAR_W);\n                var gy = Math.floor(rr.top / CHAR_H);\n                var charsInLine = Math.max(1, Math.ceil(rr.width / CHAR_W));\n                // Cap to actual remaining text length\n                var remaining = collapsed.length - charOffset;\n                if (charsInLine > remaining) charsInLine = remaining;\n                var slice = collapsed.substring(charOffset, charOffset + charsInLine);\n                if (slice) {\n                    writeToGrid(gx, gy, slice);\n\n                    // Record insertion point for this ref's label\n                    if (!firstWritten && refAncestor) {\n                        var rid = refAncestor.getAttribute('data-ref-id');\n                        if (!labeledRefs[rid]) {\n                            labeledRefs[rid] = {row: gy, col: gx};\n                        }\n                        firstWritten = true;\n                    }\n                }\n                charOffset += charsInLine;\n            }\n        }\n\n        // 5. Handle form inputs\n        var formEls = document.querySelectorAll('input, textarea, select');\n        formEls.forEach(function(el) {\n            var rect = el.getBoundingClientRect();\n            var style = window.getComputedStyle(el);\n            if (style.display === 'none' || style.visibility === 'hidden' || rect.width === 0 || rect.height === 0) return;\n\n            var x = Math.floor(rect.left / CHAR_W);\n            var y = Math.floor(rect.top / CHAR_H);\n            var w = Math.max(2, Math.ceil(rect.width / CHAR_W));\n            var h = Math.max(2, Math.ceil(rect.height / CHAR_H));\n            var midY = y + Math.floor((h - 1) / 2);\n            var refId = el.getAttribute('data-ref-id');\n\n            if (el.tagName === 'SELECT') {\n                var selectedText = el.options && el.selectedIndex >= 0 ? el.options[el.selectedIndex].text : '';\n                var selectContent = selectedText.substring(0, Math.max(0, w - 4));\n                if (selectContent) writeToGrid(x + 1, midY, selectContent);\n                writeToGrid(x + w - 2, midY, 'v');\n            } else {\n                var val = el.value || el.getAttribute('placeholder') || '';\n                if (val) writeToGrid(x + 1, midY, val);\n            }\n\n            // Track form element position for label insertion\n            if (refId && !labeledRefs[refId]) {\n                labeledRefs[refId] = {row: midY, col: x};\n            }\n        });\n\n        // Also track ref elements with no text at all (empty buttons, icons)\n        refElements.forEach(function(el) {\n            var refId = el.getAttribute('data-ref-id');\n            if (labeledRefs[refId]) return;\n            var rect = el.getBoundingClientRect();\n            var style = window.getComputedStyle(el);\n            if (style.display === 'none' || style.visibility === 'hidden' || rect.width === 0 || rect.height === 0) return;\n            labeledRefs[refId] = {row: Math.floor(rect.top / CHAR_H), col: Math.floor(rect.left / CHAR_W)};\n        });\n\n        // 6. Insert ref labels by splicing into rows (never overwrites text)\n        // Collect all labels per row, sorted right-to-left so insertions don't shift later positions\n        var rowInsertions = {}; // row -> [{col, label}]\n        refElements.forEach(function(el) {\n            var refId = el.getAttribute('data-ref-id');\n            if (!refId) return;\n            var pos = labeledRefs[refId];\n            if (!pos) return;\n            var label = '[' + refId + ']';\n            if (!rowInsertions[pos.row]) rowInsertions[pos.row] = [];\n            rowInsertions[pos.row].push({col: pos.col, label: label});\n        });\n\n        // For each row with insertions, splice labels into the row string\n        for (var rowIdx in rowInsertions) {\n            var r = parseInt(rowIdx, 10);\n            if (r < 0 || r >= gridHeight) continue;\n            var inserts = rowInsertions[r];\n            // Sort by column descending so we insert right-to-left (preserves earlier positions)\n            inserts.sort(function(a, b) { return b.col - a.col; });\n            // Convert row to string, splice in labels, write back\n            var rowStr = grid[r].join('');\n            for (var ii = 0; ii < inserts.length; ii++) {\n                var ins = inserts[ii];\n                var c = Math.max(0, Math.min(ins.col, rowStr.length));\n                // Avoid splitting inside a [...] bracket sequence \u2014 shift to before the '['\n                var openBracket = rowStr.lastIndexOf('[', c);\n                if (openBracket >= 0) {\n                    var closeBracket = rowStr.indexOf(']', openBracket);\n                    if (closeBracket >= c) {\n                        // Insertion point is inside [..], shift to before the [\n                        c = openBracket;\n                    }\n                }\n                rowStr = rowStr.substring(0, c) + ins.label + rowStr.substring(c);\n            }\n            // Write back to grid as variable-width row (will be joined as string in step 7)\n            grid[r] = rowStr.split('');\n        }\n\n        // 7. Trim output\n        var lines = [];\n        for (var r = 0; r < gridHeight; r++) {\n            lines.push(grid[r].join('').replace(/\\s+$/, ''));\n        }\n        // Drop trailing empty rows\n        while (lines.length > 0 && lines[lines.length - 1] === '') {\n            lines.pop();\n        }\n        return lines.join('\\n');\n    }\n\n    function repeat(ch, count) {\n        var s = '';\n        for (var i = 0; i < count; i++) s += ch;\n        return s;\n    }\n\n    window.generateWireframeString = generateWireframeString;\n})();\n";
+//# sourceMappingURL=normalize-script.d.ts.map

package/dist/esm/core/agent-browser/normalize-script.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize-script.d.ts","sourceRoot":"","sources":["../../../../src/core/agent-browser/normalize-script.ts"],"names":[],"mappings":"AAAA,0GAA0G;AAC1G,eAAO,MAAM,gBAAgB,44uBA6gB5B,CAAC"}