@melra/browser-runtime 0.3.0-alpha.11 → 0.3.0-alpha.13

package/dist/bounded.d.ts

@@ -0,0 +1,27 @@
+/**
+ * A browser call that did not answer within its bound.
+ *
+ * Its own type so the code that swallows a detached frame or a closed page can
+ * tell "this went away" from "this stopped answering" — the second is never an
+ * answer, and treating it as one would hide a wedged renderer behind a
+ * plausible empty result.
+ */
+export declare class BrowserCallTimeoutError extends Error {
+    constructor(what: string);
+}
+/**
+ * Settle with `call`, or fail once `ms` passes or `signal` aborts.
+ *
+ * Several Playwright calls — `title()`, `evaluate()`, `count()`, `close()`, a
+ * CDP `send` — take no timeout of their own, so a renderer that stopped
+ * answering held the action until the task budget ran out, or forever where no
+ * budget was armed. The call itself cannot be cancelled; it is left to finish
+ * or not, and its eventual rejection is consumed here rather than surfacing as
+ * an unhandled one. The timer and the abort listener are both released the
+ * moment either side wins, so nothing is left holding the process open.
+ *
+ * `ms` may be `Infinity` for a call whose only legitimate bound is the task's
+ * own budget.
+ */
+export declare function bounded<T>(call: Promise<T>, ms: number, what: string, signal?: AbortSignal): Promise<T>;
+//# sourceMappingURL=bounded.d.ts.map

package/dist/bounded.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bounded.d.ts","sourceRoot":"","sources":["../src/bounded.ts"],"names":[],"mappings":"AAGA;;;;;;;GAOG;AACH,qBAAa,uBAAwB,SAAQ,KAAK;gBACpC,IAAI,EAAE,MAAM;CAIzB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,OAAO,CAAC,CAAC,EACvB,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,EAChB,EAAE,EAAE,MAAM,EACV,IAAI,EAAE,MAAM,EACZ,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,CAAC,CAAC,CAoBZ"}

package/dist/bounded.js

@@ -0,0 +1,50 @@
+// Copyright 2026 XAGI Labs Private Limited
+// SPDX-License-Identifier: Apache-2.0
+/**
+ * A browser call that did not answer within its bound.
+ *
+ * Its own type so the code that swallows a detached frame or a closed page can
+ * tell "this went away" from "this stopped answering" — the second is never an
+ * answer, and treating it as one would hide a wedged renderer behind a
+ * plausible empty result.
+ */
+export class BrowserCallTimeoutError extends Error {
+    constructor(what) {
+        super(`browser_call_timeout:${what}`);
+        this.name = "BrowserCallTimeoutError";
+    }
+}
+/**
+ * Settle with `call`, or fail once `ms` passes or `signal` aborts.
+ *
+ * Several Playwright calls — `title()`, `evaluate()`, `count()`, `close()`, a
+ * CDP `send` — take no timeout of their own, so a renderer that stopped
+ * answering held the action until the task budget ran out, or forever where no
+ * budget was armed. The call itself cannot be cancelled; it is left to finish
+ * or not, and its eventual rejection is consumed here rather than surfacing as
+ * an unhandled one. The timer and the abort listener are both released the
+ * moment either side wins, so nothing is left holding the process open.
+ *
+ * `ms` may be `Infinity` for a call whose only legitimate bound is the task's
+ * own budget.
+ */
+export function bounded(call, ms, what, signal) {
+    return new Promise((resolve, reject) => {
+        const finish = (settle) => {
+            clearTimeout(timer);
+            signal?.removeEventListener("abort", aborted);
+            settle();
+        };
+        const aborted = () => {
+            finish(() => reject(signal?.reason ?? new Error("task_cancelled")));
+        };
+        const timer = Number.isFinite(ms)
+            ? setTimeout(() => finish(() => reject(new BrowserCallTimeoutError(what))), ms)
+            : undefined;
+        signal?.addEventListener("abort", aborted, { once: true });
+        call.then((value) => finish(() => resolve(value)), (error) => finish(() => reject(error)));
+        if (signal?.aborted === true)
+            aborted();
+    });
+}
+//# sourceMappingURL=bounded.js.map

package/dist/bounded.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bounded.js","sourceRoot":"","sources":["../src/bounded.ts"],"names":[],"mappings":"AAAA,2CAA2C;AAC3C,sCAAsC;AAEtC;;;;;;;GAOG;AACH,MAAM,OAAO,uBAAwB,SAAQ,KAAK;IAChD,YAAY,IAAY;QACtB,KAAK,CAAC,wBAAwB,IAAI,EAAE,CAAC,CAAC;QACtC,IAAI,CAAC,IAAI,GAAG,yBAAyB,CAAC;IACxC,CAAC;CACF;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,OAAO,CACrB,IAAgB,EAChB,EAAU,EACV,IAAY,EACZ,MAAoB;IAEpB,OAAO,IAAI,OAAO,CAAI,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACxC,MAAM,MAAM,GAAG,CAAC,MAAkB,EAAE,EAAE;YACpC,YAAY,CAAC,KAAK,CAAC,CAAC;YACpB,MAAM,EAAE,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YAC9C,MAAM,EAAE,CAAC;QACX,CAAC,CAAC;QACF,MAAM,OAAO,GAAG,GAAG,EAAE;YACnB,MAAM,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,IAAI,IAAI,KAAK,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC;QACtE,CAAC,CAAC;QACF,MAAM,KAAK,GAAG,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC/B,CAAC,CAAC,UAAU,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,uBAAuB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;YAC/E,CAAC,CAAC,SAAS,CAAC;QACd,MAAM,EAAE,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QAC3D,IAAI,CAAC,IAAI,CACP,CAAC,KAAK,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EACvC,CAAC,KAAc,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAChD,CAAC;QACF,IAAI,MAAM,EAAE,OAAO,KAAK,IAAI;YAAE,OAAO,EAAE,CAAC;IAC1C,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/browser-connection.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"browser-connection.d.ts","sourceRoot":"","sources":["../src/browser-connection.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAuB/D,MAAM,WAAW,wBAAwB;IACvC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,EAAE,OAAO,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;;OAKG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,cAAc,CAAC;IACxB,WAAW,EAAE,OAAO,CAAC;IACrB,WAAW,EAAE,OAAO,CAAC;CACtB;AAED,wBAAsB,uBAAuB,IAAI,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAU3E;AAED,wBAAsB,cAAc,CAClC,OAAO,EAAE,wBAAwB,GAChC,OAAO,CAAC,iBAAiB,CAAC,CAkF5B"}
+{"version":3,"file":"browser-connection.d.ts","sourceRoot":"","sources":["../src/browser-connection.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AA+B/D,MAAM,WAAW,wBAAwB;IACvC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,EAAE,OAAO,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;;OAKG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,cAAc,CAAC;IACxB,WAAW,EAAE,OAAO,CAAC;IACrB,WAAW,EAAE,OAAO,CAAC;CACtB;AAED,wBAAsB,uBAAuB,IAAI,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAU3E;AAED,wBAAsB,cAAc,CAClC,OAAO,EAAE,wBAAwB,GAChC,OAAO,CAAC,iBAAiB,CAAC,CA+F5B"}

package/dist/browser-connection.js

@@ -3,6 +3,13 @@
 import { constants } from "node:fs";
 import { access } from "node:fs/promises";
 import { chromium } from "playwright-core";
+import { bounded } from "./bounded.js";
+/**
+ * Bound on creating the first context in a browser MELRA just launched. Matches
+ * Playwright's default action timeout; a fresh browser that cannot open a
+ * context in that long is not going to.
+ */
+const NEW_CONTEXT_TIMEOUT_MS = 30_000;
 const CHROME_PATHS = {
     darwin: [
         "/Applications/Google Chrome.app/Contents/MacOS/Google Chrome",
@@ -107,13 +114,21 @@ export async function connectBrowser(options) {
             throw new Error("browser_persistent_profile_unavailable");
         return { browser, context, ownsBrowser: true, ownsContext: true };
     }
+    // `launch` carries Playwright's own 180s timeout; `newContext` carries none.
     const browser = await chromium.launch(launchOptions);
-    const context = await browser.newContext(contextOptions);
-    return {
-        browser,
-        context,
-        ownsBrowser: true,
-        ownsContext: true,
-    };
+    try {
+        const context = await bounded(browser.newContext(contextOptions), NEW_CONTEXT_TIMEOUT_MS, "new_context");
+        return {
+            browser,
+            context,
+            ownsBrowser: true,
+            ownsContext: true,
+        };
+    }
+    catch (error) {
+        // Nobody else holds this browser yet, so a failure here would leak it.
+        await bounded(browser.close(), NEW_CONTEXT_TIMEOUT_MS, "close_browser").catch(() => undefined);
+        throw error;
+    }
 }
 //# sourceMappingURL=browser-connection.js.map

package/dist/browser-connection.js.map

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

package/dist/index.d.ts

@@ -41,6 +41,32 @@ export interface BrowserRuntimeOptions extends NetworkPolicy {
  * Returns nothing when the page is clear, so a normal snapshot is unchanged.
  */
 export declare function captchaReport(frameUrls: string[]): Record<string, unknown>;
+/**
+ * Whether a Playwright action failed after its input had already been sent.
+ *
+ * A click's own timeout covers more than waiting for the element: after the
+ * mouse events go out, Playwright still asks the page to stop its hit-target
+ * check. When the click handler stalls the page, that request is what times
+ * out — with the click already delivered. Playwright logs `performing <name>
+ * action` immediately before dispatching, and the call log is part of the
+ * error, so that line is Playwright's own record that the input left. Keyboard,
+ * fill, select, and upload calls log no such line; their timeouts stay plain
+ * failures, which for them is overwhelmingly a field that never became ready.
+ *
+ * Playwright paints the call log dim when colour is on (a TTY, FORCE_COLOR),
+ * so each line can end in an escape code; those are stripped first. Without
+ * that, a click delivered under colour read as never sent: a plain failure
+ * where the outcome was unknown, seen first on the Windows CI runners.
+ */
+export declare function inputSent(error: unknown): boolean;
+/**
+ * A URL as policy names a browser target, without query or fragment. Chrome
+ * escapes two path characters Node's URL can keep raw: `|` on every Node, `^`
+ * on Node 22. Both are escaped on both sides. Nothing is decoded: no two paths
+ * a server tells apart compare equal, and no escape becomes a raw character in
+ * a message. Exported for unit testing.
+ */
+export declare function pageAddress(url: string): string;
 export declare class BrowserRuntime {
     private readonly options;
     private browser;
@@ -50,13 +76,20 @@ export declare class BrowserRuntime {
     private proxy;
     private routeHandler;
     /**
-     * Dialogs raised by the action currently running, cleared by `execute`.
+     * Dialogs raised since the last action reported, emptied when one does.
      *
      * 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.
+     * registered on the context, and because operations execute one at a time:
+     * `execute` queues them, so a task owns its runtime for one action. A dialog
+     * a page raised between actions is reported by the next one, marked
+     * `betweenActions`, rather than dropped: the transfer a late `confirm()`
+     * gated still went ahead, and the caller has to hear that it was asked.
      */
     private dialogs;
+    /** Whether an action is running, so a dialog or popup can say when it came. */
+    private acting;
+    /** The tail of the action queue; see `execute`. */
+    private queue;
     /**
      * Windows the page opened during the action currently running, same lifetime
      * as `dialogs` and reported the same way.
@@ -66,9 +99,56 @@ export declare class BrowserRuntime {
     private closing;
     /** True only while `tab_new` is opening the tab the caller asked for. */
     private openingTab;
+    /**
+     * Browser-level session that hears about a new window the moment Chromium
+     * creates it, which is what lets an action wait for a popup it knows exists
+     * instead of guessing how long one might take. Absent if the browser would
+     * not grant one; popups are then reported on Playwright's timing alone.
+     */
+    private targets;
+    /** Windows Chromium has created since tracking began, by browser context. */
+    private windowsCreated;
+    /** Windows Playwright has handed to the `page` handler, popup or not. */
+    private windowsAdopted;
+    /** This context's id in CDP, resolved on first use and then fixed. */
+    private contextId;
+    /**
+     * The running action's cancel signal and `timeoutMs`, read by `call`. Same
+     * per-action lifetime as `dialogs`, set by `execute`.
+     */
+    private signal;
+    private callMs;
+    /**
+     * Set once the running action's effect call has returned. From then on the
+     * page may have acted on it, so a failure is no longer evidence that nothing
+     * happened — see `execute`.
+     */
+    private dispatched;
     constructor(options: BrowserRuntimeOptions);
+    /**
+     * Bound a Playwright call that takes no timeout of its own by the running
+     * action's `timeoutMs` and cancel signal.
+     *
+     * `title()`, `evaluate()`, `count()`, `isVisible()`, `close()` and CDP
+     * `send` all wait for the renderer or the browser to answer, and one that
+     * stopped answering held the action until the task budget ran out — or
+     * forever, where nothing armed one. Failing with `browser_call_timeout:<what>`
+     * instead spends the budget on something that can still answer.
+     */
+    private call;
     private uploadPaths;
     private ensureContext;
+    /**
+     * Hold the action's result until Playwright has handed over every window
+     * Chromium created, so the action that opened a window is the one that
+     * reports it.
+     *
+     * Costs one round trip when nothing was opened. Waits only while a window is
+     * known to exist and is still unreported, bounded by the action's own
+     * timeout: the window is part of what the action did. A window still pending
+     * after that is reported by the action running when Playwright delivers it.
+     */
+    private awaitOpenedWindows;
     /**
      * Opens a page MELRA asked for, not one the site opened by itself.
      *
@@ -116,6 +196,10 @@ export declare class BrowserRuntime {
      *
      * 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.
+     *
+     * Resolution only reads the page and always runs before an action's effect,
+     * so a `count` that times out here fails a click or a fill cleanly: nothing
+     * was sent, and `execute` does not report it as an unknown outcome.
      */
     private locator;
     /**
@@ -146,6 +230,15 @@ export declare class BrowserRuntime {
      * reliably no matter what is in it.
      */
     private typeInto;
+    /**
+     * An attached CDP browser has no pinning proxy, and Chromium follows a
+     * redirect without showing the hop to the route guard, so an allowed page
+     * that redirects to 169.254.169.254 or a LAN address loads there. The request
+     * cannot be stopped from here; what can be is reading it back. A page whose
+     * address the guard refuses is blanked and the action fails, and a frame
+     * the guard refuses is left out.
+     */
+    private refusedFrames;
     private snapshot;
     /**
      * Read one element rather than the whole page.
@@ -157,7 +250,15 @@ export declare class BrowserRuntime {
      */
     private extract;
     private settledSnapshot;
-    execute(operation: BrowserOperation): Promise<Record<string, unknown>>;
+    /**
+     * One action at a time, in arrival order. A single runtime serves every task,
+     * and a parallel workflow node or two concurrent MCP calls used to run here
+     * at once: the second reset the first's cancel signal, timeout and
+     * `dispatched` flag mid-flight, so a click that landed was reported as a
+     * plain failure, and one task's cancel stopped another's action.
+     */
+    execute(operation: BrowserOperation, signal?: AbortSignal): Promise<Record<string, unknown>>;
+    private executeOne;
     private run;
     close(): Promise<void>;
 }
@@ -166,4 +267,5 @@ export * from "./pinning-proxy.js";
 export * from "./selector.js";
 export * from "./stable-dom.js";
 export * from "./browser-connection.js";
+export * from "./bounded.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,gBAAgB,EAAiB,MAAM,iBAAiB,CAAC;AAKvE,OAAO,EAEL,KAAK,aAAa,EACnB,MAAM,oBAAoB,CAAC;AAK5B,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;IACvB;;;;;;;;;OASG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;;;OAKG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;;;OAMG;IACH,MAAM,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC;CAC5B;AA6CD;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAiB1E;AAgGD,qBAAa,cAAc;IAyBb,OAAO,CAAC,QAAQ,CAAC,OAAO;IAxBpC,OAAO,CAAC,OAAO,CAAsB;IACrC,OAAO,CAAC,OAAO,CAA6B;IAC5C,OAAO,CAAC,UAAU,CAAmB;IACrC,OAAO,CAAC,UAAU,CAAgC;IAClD,OAAO,CAAC,KAAK,CAA2B;IACxC,OAAO,CAAC,YAAY,CAAgD;IACpE;;;;;;OAMG;IACH,OAAO,CAAC,OAAO,CAAiC;IAChD;;;OAGG;IACH,OAAO,CAAC,MAAM,CAAiC;IAC/C,2EAA2E;IAC3E,OAAO,CAAC,OAAO,CAA0B;IACzC,yEAAyE;IACzE,OAAO,CAAC,UAAU,CAAS;gBAEE,OAAO,EAAE,qBAAqB;YAE7C,WAAW;YA8BX,aAAa;IA0J3B;;;;;;OAMG;YACW,QAAQ;YASR,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;YAuB9D,GAAG;IAsTX,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CA0B7B;AAKD,OAAO,EACL,qBAAqB,EACrB,aAAa,EACb,gBAAgB,EAChB,KAAK,aAAa,EAClB,KAAK,eAAe,GACrB,MAAM,oBAAoB,CAAC;AAC5B,cAAc,oBAAoB,CAAC;AACnC,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC;AAChC,cAAc,yBAAyB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}