@melra/browser-runtime 0.3.0-alpha.3

package/dist/frames.test.js

@@ -0,0 +1,157 @@
+// Copyright 2026 XAGI Labs Private Limited
+// SPDX-License-Identifier: Apache-2.0
+import { createServer } from "node:http";
+import { mkdtemp, rm } from "node:fs/promises";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { BrowserOperationSchema } from "@melra/protocol";
+import { afterEach, describe, expect, it } from "vitest";
+import { BrowserRuntime, captchaReport, detectBrowserExecutable } from "./index.js";
+/**
+ * Consent banners, cookie walls, and captcha widgets live in iframes, and every
+ * locator used to be built from the page — which only searches the main
+ * document. An agent could see the banner in a screenshot and had no way to
+ * click it. These tests drive real frames, so they fail if that regresses.
+ */
+const BANNER = `<!doctype html><html><body>
+  <button id="accept">Accept all cookies</button>
+</body></html>`;
+/** Attaches itself after a delay, so a wait started before it exists must find it. */
+const LATE = `<!doctype html><html><body><p>loading</p><script>
+  setTimeout(() => {
+    document.body.innerHTML = '<button id="late">Continue</button>';
+  }, 400);
+</script></body></html>`;
+const PAGE = `<!doctype html><html><head><title>Framed</title></head><body>
+  <h1>Article</h1>
+  <iframe src="/banner" title="consent"></iframe>
+  <iframe src="/late" title="late"></iframe>
+</body></html>`;
+const roots = [];
+const servers = [];
+afterEach(async () => {
+    await Promise.all(servers.splice(0).map((server) => new Promise((done) => {
+        server.close(() => done());
+    })));
+    await Promise.all(roots.splice(0).map((root) => rm(root, { recursive: true, force: true })));
+});
+async function fixture() {
+    const executablePath = await detectBrowserExecutable();
+    if (executablePath === undefined)
+        return undefined;
+    const server = createServer((request, response) => {
+        const body = request.url === "/banner" ? BANNER : request.url === "/late" ? LATE : PAGE;
+        response.writeHead(200, { "content-type": "text/html; charset=utf-8" });
+        response.end(body);
+    });
+    servers.push(server);
+    await new Promise((done) => {
+        server.listen(0, "127.0.0.1", done);
+    });
+    const address = server.address();
+    if (address === null || typeof address === "string") {
+        throw new Error("fixture_server_address_unavailable");
+    }
+    const root = await mkdtemp(join(tmpdir(), "melra-frames-"));
+    roots.push(root);
+    return {
+        runtime: new BrowserRuntime({
+            workspaceRoot: root,
+            artifactDirectory: join(root, "artifacts"),
+            executablePath,
+            allowedDomains: ["127.0.0.1"],
+            allowLocalhost: true,
+        }),
+        url: `http://127.0.0.1:${address.port}`,
+    };
+}
+describe("frame-aware targeting", () => {
+    it("lists and clicks an element inside an iframe", async () => {
+        const context = await fixture();
+        if (context === undefined)
+            return;
+        const { runtime, url } = context;
+        try {
+            const observed = await runtime.execute(BrowserOperationSchema.parse({ kind: "browser", action: "navigate", url }));
+            const elements = observed.elements;
+            const accept = elements.find((item) => item.name === "Accept all cookies");
+            // The banner is in a child document, so it is absent from the page text
+            // but must still be listed, addressable, and attributed to its frame.
+            expect(String(observed.text)).not.toContain("Accept all cookies");
+            expect(accept).toBeDefined();
+            expect(accept?.frame).toContain("/banner");
+            expect(elements.every((item) => typeof item.index === "number")).toBe(true);
+            expect(new Set(elements.map((item) => item.index)).size).toBe(elements.length);
+            // The whole point: a target resolved without naming the frame.
+            const clicked = await runtime.execute(BrowserOperationSchema.parse({
+                kind: "browser",
+                action: "click",
+                target: { text: "Accept all cookies" },
+            }));
+            expect(clicked.success).toBe(true);
+        }
+        finally {
+            await runtime.close();
+        }
+    });
+    it("waits for a target that appears in a frame after the wait starts", async () => {
+        const context = await fixture();
+        if (context === undefined)
+            return;
+        const { runtime, url } = context;
+        try {
+            await runtime.execute(BrowserOperationSchema.parse({ kind: "browser", action: "navigate", url }));
+            const waited = await runtime.execute(BrowserOperationSchema.parse({
+                kind: "browser",
+                action: "wait",
+                target: { text: "Continue" },
+                state: "visible",
+                timeoutMs: 5_000,
+            }));
+            expect(waited.waited).toBe(true);
+        }
+        finally {
+            await runtime.close();
+        }
+    });
+    it("does not report a target as hidden merely because other frames lack it", async () => {
+        const context = await fixture();
+        if (context === undefined)
+            return;
+        const { runtime, url } = context;
+        try {
+            await runtime.execute(BrowserOperationSchema.parse({ kind: "browser", action: "navigate", url }));
+            // The banner is visible in exactly one of three frames. A per-candidate
+            // "some frame is missing it" test would call that hidden immediately.
+            await expect(runtime.execute(BrowserOperationSchema.parse({
+                kind: "browser",
+                action: "wait",
+                target: { text: "Accept all cookies" },
+                state: "hidden",
+                timeoutMs: 700,
+            }))).rejects.toThrow(/browser_wait_timeout:hidden/);
+        }
+        finally {
+            await runtime.close();
+        }
+    });
+});
+describe("captchaReport", () => {
+    it("names the vendor of a human-verification widget", () => {
+        const report = captchaReport([
+            "http://127.0.0.1:8080/",
+            "https://www.google.com/recaptcha/api2/anchor?k=abc",
+            "https://challenges.cloudflare.com/cdn-cgi/challenge-platform/turnstile",
+        ]);
+        const captcha = report.captcha;
+        expect(captcha.present).toBe(true);
+        expect(captcha.vendors).toEqual(["recaptcha", "turnstile"]);
+    });
+    it("stays silent on a page with no challenge", () => {
+        expect(captchaReport(["https://example.com/", "https://cdn.example.com/ad"])).toEqual({});
+    });
+    it("does not match a lookalike host outside the vendor domain", () => {
+        expect(captchaReport(["https://hcaptcha.com.evil.test/x"])).toEqual({});
+    });
+});
+//# sourceMappingURL=frames.test.js.map

package/dist/frames.test.js.map

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

package/dist/history-tabs.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=history-tabs.test.d.ts.map

package/dist/history-tabs.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"history-tabs.test.d.ts","sourceRoot":"","sources":["../src/history-tabs.test.ts"],"names":[],"mappings":""}

package/dist/history-tabs.test.js

@@ -0,0 +1,171 @@
+// Copyright 2026 XAGI Labs Private Limited
+// SPDX-License-Identifier: Apache-2.0
+import { createServer } from "node:http";
+import { mkdtemp, rm } from "node:fs/promises";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { BrowserOperationSchema } from "@melra/protocol";
+import { afterEach, describe, expect, it } from "vitest";
+import { BrowserRuntime, detectBrowserExecutable } from "./index.js";
+/**
+ * A session could only ever move forward, in one tab. There was no `back`, so a
+ * wrong click was unrecoverable without re-navigating from scratch, and `tabs`
+ * reported which page was `active` while nothing could change it — the
+ * `tabIndex` schema field existed but was read only by `close`.
+ */
+const roots = [];
+const servers = [];
+afterEach(async () => {
+    await Promise.all(servers.splice(0).map((server) => new Promise((done) => {
+        server.close(() => done());
+    })));
+    await Promise.all(roots.splice(0).map((root) => rm(root, { recursive: true, force: true })));
+});
+/** Serves /one, /two, /three, each naming itself in the title and body. */
+async function fixture() {
+    const executablePath = await detectBrowserExecutable();
+    if (executablePath === undefined)
+        return undefined;
+    const server = createServer((request, response) => {
+        const name = (request.url ?? "/").slice(1) || "one";
+        response.writeHead(200, { "content-type": "text/html; charset=utf-8" });
+        response.end(`<!doctype html><html><head><title>${name}</title></head><body><h1>${name}</h1></body></html>`);
+    });
+    servers.push(server);
+    await new Promise((done) => {
+        server.listen(0, "127.0.0.1", done);
+    });
+    const address = server.address();
+    if (address === null || typeof address === "string") {
+        throw new Error("fixture_server_address_unavailable");
+    }
+    const root = await mkdtemp(join(tmpdir(), "melra-history-tabs-"));
+    roots.push(root);
+    return {
+        runtime: new BrowserRuntime({
+            workspaceRoot: root,
+            artifactDirectory: join(root, "artifacts"),
+            executablePath,
+            allowedDomains: ["127.0.0.1"],
+            allowLocalhost: true,
+        }),
+        url: `http://127.0.0.1:${address.port}`,
+    };
+}
+const op = (fields) => BrowserOperationSchema.parse({ kind: "browser", ...fields });
+describe("browser history", () => {
+    it("moves back and forward through the history stack", async () => {
+        const context = await fixture();
+        if (context === undefined)
+            return;
+        const { runtime, url } = context;
+        try {
+            await runtime.execute(op({ action: "navigate", url: `${url}/one` }));
+            await runtime.execute(op({ action: "navigate", url: `${url}/two` }));
+            const back = await runtime.execute(op({ action: "back" }));
+            expect(back.moved).toBe(true);
+            expect(back.title).toBe("one");
+            const forward = await runtime.execute(op({ action: "forward" }));
+            expect(forward.moved).toBe(true);
+            expect(forward.title).toBe("two");
+        }
+        finally {
+            await runtime.close();
+        }
+    }, 120_000);
+    it("reports a move with no HTTP response, and the end of the stack, differently", async () => {
+        const context = await fixture();
+        if (context === undefined)
+            return;
+        const { runtime, url } = context;
+        try {
+            await runtime.execute(op({ action: "navigate", url: `${url}/one` }));
+            // A page starts on `about:blank`, which is a real history entry but
+            // produces no HTTP response, so Playwright reports the same `null` it
+            // reports for "nowhere to go". This moved.
+            const blank = await runtime.execute(op({ action: "back" }));
+            expect(blank.moved).toBe(true);
+            expect(blank.status).toBe(null);
+            expect(blank.url).toBe("about:blank");
+            // Now there genuinely is nothing before it. "Go back unless already at
+            // the start" is a normal thing to want, so this reports rather than
+            // throws, and it must not look like the case above.
+            const end = await runtime.execute(op({ action: "back" }));
+            expect(end.moved).toBe(false);
+            expect(end.url).toBe("about:blank");
+        }
+        finally {
+            await runtime.close();
+        }
+    }, 120_000);
+    it("reloads the current page in place", async () => {
+        const context = await fixture();
+        if (context === undefined)
+            return;
+        const { runtime, url } = context;
+        try {
+            await runtime.execute(op({ action: "navigate", url: `${url}/three` }));
+            const reloaded = await runtime.execute(op({ action: "reload" }));
+            expect(reloaded.status).toBe(200);
+            expect(reloaded.url).toBe(`${url}/three`);
+        }
+        finally {
+            await runtime.close();
+        }
+    }, 120_000);
+});
+describe("browser tabs", () => {
+    it("opens a tab, switches between tabs, and closes one", async () => {
+        const context = await fixture();
+        if (context === undefined)
+            return;
+        const { runtime, url } = context;
+        try {
+            await runtime.execute(op({ action: "navigate", url: `${url}/one` }));
+            const opened = await runtime.execute(op({ action: "tab_new", url: `${url}/two` }));
+            expect(opened.opened).toBe(true);
+            expect(opened.index).toBe(1);
+            // A new tab becomes the active one, so the next action lands on it.
+            expect((await runtime.execute(op({ action: "inspect" }))).title).toBe("two");
+            const switched = await runtime.execute(op({ action: "tab_switch", tabIndex: 0 }));
+            expect(switched.switched).toBe(true);
+            expect(switched.tabs.find((tab) => tab.active)?.index).toBe(0);
+            expect((await runtime.execute(op({ action: "inspect" }))).title).toBe("one");
+            const closed = await runtime.execute(op({ action: "close", tabIndex: 1 }));
+            expect(closed.tabs.length).toBe(1);
+        }
+        finally {
+            await runtime.close();
+        }
+    }, 120_000);
+    it("refuses a tab index that does not exist", async () => {
+        const context = await fixture();
+        if (context === undefined)
+            return;
+        const { runtime, url } = context;
+        try {
+            await runtime.execute(op({ action: "navigate", url: `${url}/one` }));
+            await expect(runtime.execute(op({ action: "tab_switch", tabIndex: 7 }))).rejects.toThrow("browser_tab_not_found");
+            await expect(runtime.execute(op({ action: "tab_switch" }))).rejects.toThrow("browser_tab_switch_requires_tab_index");
+        }
+        finally {
+            await runtime.close();
+        }
+    }, 120_000);
+    it("blocks a disallowed domain when opening a tab", async () => {
+        const context = await fixture();
+        if (context === undefined)
+            return;
+        const { runtime, url } = context;
+        try {
+            await runtime.execute(op({ action: "navigate", url: `${url}/one` }));
+            // `tab_new` takes a url, so it has to run the same guard `navigate` does
+            // rather than becoming a way around the allowlist.
+            await expect(runtime.execute(op({ action: "tab_new", url: "http://169.254.169.254/latest" }))).rejects.toThrow();
+        }
+        finally {
+            await runtime.close();
+        }
+    }, 120_000);
+});
+//# sourceMappingURL=history-tabs.test.js.map

package/dist/history-tabs.test.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,124 @@
+import type { BrowserOperation } from "@melra/protocol";
+import { type NetworkPolicy } from "./network-policy.js";
+export interface BrowserRuntimeOptions extends NetworkPolicy {
+    artifactDirectory: string;
+    workspaceRoot: string;
+    executablePath?: string;
+    headless?: boolean;
+    cdpEndpoint?: string;
+    cdpContextIndex?: number;
+    recordHarPath?: string;
+}
+/**
+ * Name any human-verification widget embedded in the page.
+ *
+ * Returns nothing when the page is clear, so a normal snapshot is unchanged.
+ */
+export declare function captchaReport(frameUrls: string[]): Record<string, unknown>;
+export declare class BrowserRuntime {
+    private readonly options;
+    private browser;
+    private context;
+    private activePage;
+    private connection;
+    private routeHandler;
+    /**
+     * Dialogs raised by the action currently running, cleared by `execute`.
+     *
+     * One buffer on the runtime rather than one per page because the handler is
+     * registered on the context, and because operations execute one at a time —
+     * a task owns its runtime for the length of one action.
+     */
+    private dialogs;
+    constructor(options: BrowserRuntimeOptions);
+    private uploadPaths;
+    private ensureContext;
+    private page;
+    /**
+     * The tab list, with the index each entry can be addressed by.
+     *
+     * Returned by every tab action rather than only by `tabs`, because opening,
+     * switching, and closing all renumber the list — a caller that had to issue a
+     * separate `tabs` call after each one would be acting on a stale index.
+     */
+    private describeTabs;
+    /**
+     * The frames a target may live in, main frame first.
+     *
+     * Consent banners, cookie walls, payment fields, and captcha widgets are
+     * almost always in an iframe, and `page.locator` only ever searched the main
+     * document — so the element an agent could plainly see in a screenshot was
+     * unaddressable, and the run died on an action timeout. Searching every frame
+     * with the main one first keeps precise callers unaffected and makes the
+     * embedded case work without a new field to pass.
+     *
+     * Ad and analytics pages can attach dozens of frames, so the list is bounded.
+     */
+    private frames;
+    /**
+     * Every way the caller gave us to find the element, in the order we trust
+     * them. Split out from `locator` because waiting and acting need the same
+     * list but disagree about what to do when nothing matches yet.
+     */
+    private candidates;
+    /**
+     * Resolve a target to a locator that actually matches something.
+     *
+     * Text matching used to be `exact: true` only, which fails on the whitespace,
+     * casing, and nested-markup differences that real pages are full of — a button
+     * rendered as `<button> Sign in </button>` never matched `"Sign in"`. Exact is
+     * still tried first so a precise caller keeps precise behaviour; the substring
+     * form is only consulted when exact found nothing.
+     *
+     * A target that matches nothing is reported as such instead of being handed to
+     * Playwright to fail as an opaque action timeout thirty seconds later.
+     */
+    private locator;
+    /**
+     * Wait for a target to reach a state, re-resolving it on every poll.
+     *
+     * Playwright's own `waitFor` is bound to one frame decided up front, which is
+     * exactly wrong here: the consent iframe or captcha widget being waited for
+     * usually does not exist yet when the wait starts. Re-reading `page.frames()`
+     * each round costs a poll interval of latency and covers the frame that
+     * appears halfway through.
+     *
+     * `visible` and `attached` are satisfied by any one candidate; `hidden` and
+     * `detached` must hold for all of them. Fanning out across frames makes that
+     * distinction load-bearing — most frames never contain the target, so "some
+     * candidate is absent" is true from the first poll and would report a banner
+     * as dismissed while it is still on screen.
+     */
+    private waitForTarget;
+    /**
+     * Type by pressing keys rather than by assigning the value.
+     *
+     * `.fill()` sets the field and fires a single `input` event. Anything that
+     * listens for keystrokes never sees the text: React inputs with key handlers,
+     * autocomplete dropdowns, comboboxes that filter as you type, and fields that
+     * enable a submit button only after a `keyup`. The old server used
+     * `page.type`, and losing that is most of why typing "stopped working".
+     * `.fill("")` is still how the field gets cleared, because it empties one
+     * reliably no matter what is in it.
+     */
+    private typeInto;
+    private snapshot;
+    /**
+     * Read one element rather than the whole page.
+     *
+     * The old server had `extract_text` and `extract_html`; both were dropped, so
+     * a caller wanting one table out of a large document had to take the entire
+     * page text and cut it up itself. `inspect` already accepts a target, so
+     * scoping it needs no new action.
+     */
+    private extract;
+    private settledSnapshot;
+    execute(operation: BrowserOperation): Promise<Record<string, unknown>>;
+    private run;
+    close(): Promise<void>;
+}
+export * from "./network-policy.js";
+export * from "./selector.js";
+export * from "./stable-dom.js";
+export * from "./browser-connection.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,gBAAgB,EAAiB,MAAM,iBAAiB,CAAC;AAKvE,OAAO,EAEL,KAAK,aAAa,EACnB,MAAM,qBAAqB,CAAC;AAI7B,MAAM,WAAW,qBAAsB,SAAQ,aAAa;IAC1D,iBAAiB,EAAE,MAAM,CAAC;IAC1B,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAsCD;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAiB1E;AAgGD,qBAAa,cAAc;IAeb,OAAO,CAAC,QAAQ,CAAC,OAAO;IAdpC,OAAO,CAAC,OAAO,CAAsB;IACrC,OAAO,CAAC,OAAO,CAA6B;IAC5C,OAAO,CAAC,UAAU,CAAmB;IACrC,OAAO,CAAC,UAAU,CAAgC;IAClD,OAAO,CAAC,YAAY,CAAgD;IACpE;;;;;;OAMG;IACH,OAAO,CAAC,OAAO,CAAiC;gBAEnB,OAAO,EAAE,qBAAqB;YAE7C,WAAW;YA8BX,aAAa;YAqFb,IAAI;IASlB;;;;;;OAMG;YACW,YAAY;IAa1B;;;;;;;;;;;OAWG;IACH,OAAO,CAAC,MAAM;IAId;;;;OAIG;IACH,OAAO,CAAC,UAAU;IAwBlB;;;;;;;;;;;OAWG;YACW,OAAO;IAarB;;;;;;;;;;;;;;OAcG;YACW,aAAa;IAsC3B;;;;;;;;;;OAUG;YACW,QAAQ;YAeR,QAAQ;IAwCtB;;;;;;;OAOG;YACW,OAAO;YAqBP,eAAe;IAcvB,OAAO,CAAC,SAAS,EAAE,gBAAgB,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;YAe9D,GAAG;IAsTX,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAuB7B;AAED,cAAc,qBAAqB,CAAC;AACpC,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC;AAChC,cAAc,yBAAyB,CAAC"}