humanish 0.76.0 → 0.78.0

package/README.md

@@ -53,8 +53,8 @@ npx humanish run first-run    # a study with no keys and no spend — about a mi
 npx humanish run try-live     # a REAL study on a hosted desktop, capped at $2
 ```
 
-**What it finds, measured (2026-09-01 and 09-03, receipts in `bench/` and `docs/goals/`):** 43 of
-45 planted defects over three benchmark runs on an app we wrote, none invented on the clean arm; on
+**What it finds, measured (2026-09-01 to 09-04, receipts in `bench/` and `docs/goals/`):** 58 of
+60 planted defects over four benchmark runs on an app we wrote, none invented in 15 clean runs; on
 two apps we did not write, 16 of 18 distinct findings confirmed against the source and 0 invented,
 across 14 participants; a drawDB modal reported by 5 of 5 keyboard-first participants (3 stopped
 there) and never mentioned by 5 mouse-driving newcomers; a TodoMVC rename that blocked 6 of 6
@@ -483,8 +483,10 @@ and `resolved`: what the page itself reported afterwards (`navigator.userAgent`,
 `devicePixelRatio`, `innerWidth`, `maxTouchPoints`, coarse pointer). A page without a viewport
 meta lays out at 980 px, as it would on a phone, and the bundle says so. Firefox cannot be
 emulated, so the lane fails closed instead of shipping a desktop run labelled mobile. The
-emulation covers the launch tab (the user agent and touch flags are browser-wide); a bundle
-without a `fidelity` block is a responsive-viewport study whatever its preset is called.
+viewport and DPR override cover the launch tab (the user agent and touch flags are browser-wide);
+if an observation reads a tab the participant opened later, the lane records one warning saying
+so, because that tab laid out at the window width. A bundle without a `fidelity` block is a
+responsive-viewport study whatever its preset is called.
 
 **Desktop browser choice.** Hosted computer-use lanes and shared-world actor seats use the
 route's historical opener unless you set `execution.desktop.browser` to `chrome`, `chromium`,

package/dist/chrome-cdp-probe.d.ts

@@ -21,8 +21,10 @@ export interface ChromeCdpProbeArgs {
     /**
      * "state": url/title/text/scrollY. "geometry": outer window + CSS viewport. "port": resolution
      * only. "emulate": apply mobile emulation (#221) to the selected page and exit (the overrides that
-     * are session-scoped, UA / touch / DPR, lapse when the socket closes). "hold": the same, then keep
-     * the socket open until killed, which is how a lane keeps them for its whole life. "fidelity": read
+     * are session-scoped, UA / touch / DPR, lapse when the socket closes). "hold": the same over a browser-level
+     * socket, then stay attached until killed (how a lane keeps them for its whole life) and attach
+     * to every page target Chrome opens later, sending it the same overrides and a reload the moment
+     * it exists, never pausing it (#623). "fidelity": read
      * back what the page reports about itself (UA, DPR, viewport, touch), the proof for the bundle.
      */
     mode: "state" | "geometry" | "port" | "emulate" | "hold" | "fidelity";

package/dist/chrome-cdp-probe.js

@@ -73,116 +73,128 @@ def select_page(pages, args):
         return match
     return http_pages[0] if len(http_pages) == 1 else None
 
-def ws_session(ws_url, messages, timeout=1.5, hold=False):
-    """Send CDP messages over one page socket, in order, and return their replies (None on failure).
-    hold=True prints the replies and then keeps the socket open until the process is killed."""
-    match = re.match(r"^ws://([^/:]+):(\d+)(/.*)$", str(ws_url or ""))
-    if not match:
-        return None
-    host, port, path = match.group(1), int(match.group(2)), match.group(3)
-    sock = None
-    try:
-        sock = socket.create_connection((host, port), timeout=timeout)
-        sock.settimeout(timeout)
+class Ws:
+    """One DevTools WebSocket: hand-rolled client frames, JSON in and out; events that arrive while
+    a reply is awaited are kept in .events for the caller."""
+    def __init__(self, ws_url, timeout=1.5):
+        match = re.match(r"^ws://([^/:]+):(\d+)(/.*)$", str(ws_url or ""))
+        if not match:
+            raise ValueError("not a ws url")
+        host, port, path = match.group(1), int(match.group(2)), match.group(3)
+        self.sock = socket.create_connection((host, port), timeout=timeout)
+        self.sock.settimeout(timeout)
         key = base64.b64encode(os.urandom(16)).decode("ascii")
-        handshake = (
+        self.sock.sendall((
             "GET %s HTTP/1.1\r\nHost: %s:%d\r\nUpgrade: websocket\r\nConnection: Upgrade\r\n"
             "Sec-WebSocket-Key: %s\r\nSec-WebSocket-Version: 13\r\n\r\n" % (path, host, port, key)
-        )
-        sock.sendall(handshake.encode("ascii"))
+        ).encode("ascii"))
         buffer = b""
         while b"\r\n\r\n" not in buffer:
-            chunk = sock.recv(4096)
+            chunk = self.sock.recv(4096)
             if not chunk:
-                return None
+                raise EOFError("closed during the handshake")
             buffer += chunk
-        head, buffer = buffer.split(b"\r\n\r\n", 1)
+        head, self.buffer = buffer.split(b"\r\n\r\n", 1)
         if b" 101 " not in head.split(b"\r\n", 1)[0]:
-            return None
-        state = {"buffer": buffer}
+            raise EOFError("handshake refused")
+        self.next_id = 0
+        self.events = []
 
-        def need(count):
-            while len(state["buffer"]) < count:
-                chunk = sock.recv(65536)
-                if not chunk:
-                    raise EOFError("socket closed")
-                state["buffer"] += chunk
+    def need(self, count):
+        while len(self.buffer) < count:
+            chunk = self.sock.recv(65536)
+            if not chunk:
+                raise EOFError("socket closed")
+            self.buffer += chunk
 
-        def send(message):
-            payload = json.dumps(message).encode("utf-8")
-            mask = os.urandom(4)
-            frame = bytearray([0x81])
-            size = len(payload)
-            if size < 126:
-                frame.append(0x80 | size)
-            elif size < 65536:
-                frame.append(0x80 | 126)
-                frame += struct.pack(">H", size)
-            else:
-                frame.append(0x80 | 127)
-                frame += struct.pack(">Q", size)
-            frame += mask + bytes(byte ^ mask[index % 4] for index, byte in enumerate(payload))
-            sock.sendall(bytes(frame))
+    def send(self, method, params=None, session_id=None):
+        self.next_id += 1
+        message = {"id": self.next_id, "method": method, "params": params or {}}
+        if session_id:
+            message["sessionId"] = session_id
+        payload = json.dumps(message).encode("utf-8")
+        mask = os.urandom(4)
+        frame = bytearray([0x81])
+        size = len(payload)
+        if size < 126:
+            frame.append(0x80 | size)
+        elif size < 65536:
+            frame.append(0x80 | 126)
+            frame += struct.pack(">H", size)
+        else:
+            frame.append(0x80 | 127)
+            frame += struct.pack(">Q", size)
+        frame += mask + bytes(byte ^ mask[index % 4] for index, byte in enumerate(payload))
+        self.sock.sendall(bytes(frame))
+        return self.next_id
 
-        def receive(wanted_id):
-            message = b""
-            while True:
-                need(2)
-                first, second = state["buffer"][0], state["buffer"][1]
-                fin, opcode = first & 0x80, first & 0x0F
-                masked, length, offset = second & 0x80, second & 0x7F, 2
-                if length == 126:
-                    need(4)
-                    length, offset = struct.unpack(">H", state["buffer"][2:4])[0], 4
-                elif length == 127:
-                    need(10)
-                    length, offset = struct.unpack(">Q", state["buffer"][2:10])[0], 10
-                frame_mask = b""
-                if masked:
-                    need(offset + 4)
-                    frame_mask, offset = state["buffer"][offset:offset + 4], offset + 4
-                need(offset + length)
-                data = state["buffer"][offset:offset + length]
-                state["buffer"] = state["buffer"][offset + length:]
-                if masked:
-                    data = bytes(byte ^ frame_mask[index % 4] for index, byte in enumerate(data))
-                if opcode == 8:
+    def recv(self):
+        """The next JSON message (a reply or an event), or None once the socket closes."""
+        message = b""
+        while True:
+            self.need(2)
+            first, second = self.buffer[0], self.buffer[1]
+            fin, opcode = first & 0x80, first & 0x0F
+            masked, length, offset = second & 0x80, second & 0x7F, 2
+            if length == 126:
+                self.need(4)
+                length, offset = struct.unpack(">H", self.buffer[2:4])[0], 4
+            elif length == 127:
+                self.need(10)
+                length, offset = struct.unpack(">Q", self.buffer[2:10])[0], 10
+            frame_mask = b""
+            if masked:
+                self.need(offset + 4)
+                frame_mask, offset = self.buffer[offset:offset + 4], offset + 4
+            self.need(offset + length)
+            data = self.buffer[offset:offset + length]
+            self.buffer = self.buffer[offset + length:]
+            if masked:
+                data = bytes(byte ^ frame_mask[index % 4] for index, byte in enumerate(data))
+            if opcode == 8:
+                return None
+            if opcode in (9, 10):
+                continue
+            message += data
+            if fin:
+                try:
+                    reply = json.loads(message.decode("utf-8"))
+                except Exception:
                     return None
-                if opcode in (9, 10):
-                    continue
-                message += data
-                if fin:
-                    try:
-                        reply = json.loads(message.decode("utf-8"))
-                    except Exception:
-                        return None
-                    message = b""
-                    if isinstance(reply, dict) and reply.get("id") == wanted_id:
-                        return reply
+                message = b""
+                if isinstance(reply, dict):
+                    return reply
 
-        replies = []
-        for index, message in enumerate(messages, 1):
-            send({"id": index, **message})
-            replies.append(receive(index))
-        if hold:
-            # Announce the result now (the caller reads stdout once), then stay attached.
-            applied = [m["method"] for m, r in zip(messages, replies) if isinstance(r, dict) and "error" not in r]
-            failed = [m["method"] for m, r in zip(messages, replies) if not (isinstance(r, dict) and "error" not in r)]
-            print(json.dumps({"applied": applied, "held": not failed, **({"unavailable": "%s failed" % failed[0]} if failed else {})}), flush=True)
-            if failed:
-                return replies
-            sock.settimeout(None)
-            while True:
-                time.sleep(30)
-        return replies
+    def call(self, method, params=None, session_id=None):
+        """Send one command and wait for its reply; events seen on the way are queued."""
+        wanted = self.send(method, params, session_id)
+        while True:
+            reply = self.recv()
+            if reply is None:
+                return None
+            if reply.get("id") == wanted:
+                return reply
+            if "method" in reply:
+                self.events.append(reply)
+
+    def close(self):
+        try:
+            self.sock.close()
+        except Exception:
+            pass
+
+def ws_session(ws_url, messages, timeout=1.5):
+    """Send CDP messages over one page socket, in order, and return their replies (None on failure)."""
+    try:
+        ws = Ws(ws_url, timeout)
+    except Exception:
+        return None
+    try:
+        return [ws.call(message["method"], message.get("params")) for message in messages]
     except Exception:
         return None
     finally:
-        if sock is not None:
-            try:
-                sock.close()
-            except Exception:
-                pass
+        ws.close()
 
 def evaluate(ws_url, expression, timeout=1.5):
     replies = ws_session(ws_url, [{"method": "Runtime.evaluate", "params": {"returnByValue": True, "expression": expression}}], timeout)
@@ -208,9 +220,8 @@ FIDELITY_EXPRESSION = (
     "coarsePointer: !!(window.matchMedia && window.matchMedia('(pointer: coarse)').matches) })"
 )
 
-def emulate(ws_url, request, hold=False):
-    """Apply the Emulation domain to the page and reload it so scripts that read the UA at load see it.
-    With hold=True the socket stays open (the overrides are bound to this session) until the process is killed."""
+def emulation_messages(request, reload):
+    """The Emulation domain for one page session; reload only where scripts already ran at load."""
     width = int(request.get("width") or 0)
     height = int(request.get("height") or 0)
     scale = float(request.get("deviceScaleFactor") or 1)
@@ -229,10 +240,11 @@ def emulate(ws_url, request, hold=False):
         if platform:
             params["platform"] = platform
         messages.append({"method": "Emulation.setUserAgentOverride", "params": params})
-    messages.append({"method": "Page.reload", "params": {}})
-    replies = ws_session(ws_url, messages, timeout=5, hold=hold)
-    if replies is None:
-        return None, "the page socket could not be opened"
+    if reload:
+        messages.append({"method": "Page.reload", "params": {}})
+    return messages
+
+def applied_of(messages, replies):
     applied = []
     for message, reply in zip(messages, replies):
         if isinstance(reply, dict) and "error" not in reply:
@@ -242,6 +254,122 @@ def emulate(ws_url, request, hold=False):
             return applied, "%s failed: %s" % (message["method"], detail)
     return applied, None
 
+def emulate(ws_url, request):
+    """One-shot: apply the Emulation domain to the page and reload it. The session-scoped overrides
+    lapse when this socket closes; the lane uses hold() instead."""
+    messages = emulation_messages(request, reload=True)
+    replies = ws_session(ws_url, messages, timeout=5)
+    if replies is None:
+        return None, "the page socket could not be opened"
+    return applied_of(messages, replies)
+
+def apply_over(ws, request, session_id, reload):
+    messages = emulation_messages(request, reload)
+    return applied_of(messages, [ws.call(m["method"], m.get("params"), session_id) for m in messages])
+
+def browser_ws_url(port):
+    opener = urllib.request.build_opener(urllib.request.ProxyHandler({}))
+    with opener.open("http://127.0.0.1:%d/json/version" % port, timeout=2) as response:
+        info = json.loads(response.read().decode("utf-8"))
+    return str(info.get("webSocketDebuggerUrl") or "")
+
+def hold(port, page, request):
+    """Emulate the launch page and then every page target Chrome opens later, for as long as this
+    process lives (#221, #623). One browser-level socket with flattened sessions: the launch page is
+    attached by id and reloaded so scripts that read the UA at load see it; a target that appears
+    later is attached the moment it exists, sent the same overrides, and reloaded once after its
+    first real navigation commits (touch emulation reaches a document only when it loads under it).
+    Two things this loop must never do (measured on a real desktop, 2026-09-04): pause new targets
+    (waitForDebuggerOnStart) and wait for their replies. A popup a participant taps open shares its
+    opener's renderer, answers Emulation commands only once it runs, and a loop blocked on that
+    reply never resumed the tab (it loaded forever) and never reached the next one. Overrides are
+    sent without waiting; replies, errors included, are logged as they arrive.
+    Prints one JSON line per attached target; the first line is the announce the lane reads."""
+    launch_id = str(page.get("id") or "")
+    try:
+        ws = Ws(browser_ws_url(port), timeout=5)
+    except Exception as error:
+        print(json.dumps({"unavailable": "the browser socket could not be opened (%s)" % type(error).__name__}), flush=True)
+        return
+    attach = ws.call("Target.attachToTarget", {"targetId": launch_id, "flatten": True})
+    session_id = ((attach or {}).get("result") or {}).get("sessionId") if isinstance(attach, dict) else None
+    if not session_id:
+        print(json.dumps({"unavailable": "Target.attachToTarget failed for the launch page"}), flush=True)
+        return
+    covered = {launch_id}
+    applied, failure = apply_over(ws, request, session_id, reload=True)
+    print(json.dumps({"applied": applied, "held": failure is None, "targetId": launch_id, **({"unavailable": failure} if failure else {})}), flush=True)
+    if failure:
+        return
+    auto = ws.call("Target.setAutoAttach", {"autoAttach": True, "waitForDebuggerOnStart": False, "flatten": True})
+    if not isinstance(auto, dict) or "error" in auto:
+        print(json.dumps({"autoAttach": False, "unavailable": "Target.setAutoAttach failed; later tabs are not emulated"}), flush=True)
+    ws.sock.settimeout(None)
+    pending = {}
+    # Sessions of later targets that still owe one reload: touch emulation reaches a document only
+    # when it loads under the override (measured: a popup's first document reported
+    # maxTouchPoints 0 with the viewport already 414 px), so each later tab is reloaded once after
+    # its first real navigation commits, or at once when it had already committed at attach time.
+    reload_owed = {}
+    while True:
+        try:
+            message = ws.events.pop(0) if ws.events else ws.recv()
+        except Exception as error:
+            print(json.dumps({"holderExit": "%s: %s" % (type(error).__name__, error)}), flush=True)
+            return
+        if message is None:
+            print(json.dumps({"holderExit": "browser socket closed"}), flush=True)
+            return
+        reply_id = message.get("id")
+        session = message.get("sessionId")
+        if reply_id in pending:
+            method = pending.pop(reply_id)
+            if "error" in message:
+                print(json.dumps({"replyError": method, "message": str((message.get("error") or {}).get("message"))}), flush=True)
+            elif method == "href" and session in reload_owed:
+                # The navigation may have committed before Page.enable could report it; the page's
+                # own location says so, and the reload it is owed goes out now (once: pop guards it).
+                href = str((((message.get("result") or {}).get("result") or {}).get("value")) or "")
+                if href and not href.startswith("about:"):
+                    target_id = reload_owed.pop(session)
+                    pending[ws.send("Page.reload", {}, session)] = "Page.reload"
+                    print(json.dumps({"reloaded": target_id, "url": href, "by": "href"}), flush=True)
+            continue
+        method = message.get("method")
+        params = message.get("params") or {}
+        if method == "Page.frameNavigated" and session in reload_owed:
+            frame = params.get("frame") or {}
+            url = str(frame.get("url") or "")
+            if not frame.get("parentId") and url and not url.startswith("about:"):
+                target_id = reload_owed.pop(session)
+                pending[ws.send("Page.reload", {}, session)] = "Page.reload"
+                print(json.dumps({"reloaded": target_id, "url": url}), flush=True)
+            continue
+        if method != "Target.attachedToTarget":
+            continue
+        info = params.get("targetInfo") or {}
+        new_session = params.get("sessionId")
+        target_id = str(info.get("targetId") or "")
+        if info.get("type") == "page" and target_id and target_id not in covered:
+            covered.add(target_id)
+            messages = emulation_messages(request, reload=False)
+            for m in messages:
+                pending[ws.send(m["method"], m.get("params"), new_session)] = m["method"]
+            pending[ws.send("Page.enable", {}, new_session)] = "Page.enable"
+            url = str(info.get("url") or "")
+            if url and not url.startswith("about:"):
+                pending[ws.send("Page.reload", {}, new_session)] = "Page.reload"
+                print(json.dumps({"attached": target_id, "sent": [m["method"] for m in messages] + ["Page.reload"], "url": url}), flush=True)
+            else:
+                reload_owed[new_session] = target_id
+                # Two ways to learn the first real navigation committed, whichever answers first:
+                # Page.frameNavigated (if Page.enable landed before the commit) or the page's own
+                # location.href (if it did not).
+                pending[ws.send("Runtime.evaluate", {"expression": "location.href", "returnByValue": True}, new_session)] = "href"
+                print(json.dumps({"attached": target_id, "sent": [m["method"] for m in messages], "reloadAfterNavigation": True}), flush=True)
+        if params.get("waitingForDebugger"):
+            ws.send("Runtime.runIfWaitingForDebugger", {}, new_session)
+
 def main():
     args = json.loads(sys.argv[1]) if len(sys.argv) > 1 else {}
     mode = args.get("mode") or "state"
@@ -258,7 +386,11 @@ def main():
     if page is None:
         print(json.dumps({"unavailable": "no http page among %d CDP targets on 127.0.0.1:%d" % (len(pages), port)}))
         return
-    ws_url = page.get("webSocketDebuggerUrl")
+    # Chrome omits webSocketDebuggerUrl from /json while another DevTools client is attached to the
+    # page, or for a moment after one detaches; the page socket URL is still /devtools/page/<id>.
+    ws_url = page.get("webSocketDebuggerUrl") or (
+        "ws://127.0.0.1:%d/devtools/page/%s" % (port, page.get("id")) if page.get("id") else None
+    )
     if mode == "emulate":
         applied, failure = emulate(ws_url, args.get("emulation") or {}) if ws_url else (None, "the page has no socket")
         if failure is not None:
@@ -267,13 +399,9 @@ def main():
         print(json.dumps({"applied": applied, "targetId": str(page.get("id") or "")}))
         return
     if mode == "hold":
-        if not ws_url:
-            print(json.dumps({"unavailable": "the page has no socket"}), flush=True)
-            return
-        # Prints its own line from inside ws_session (before blocking) and never returns on success.
-        applied, failure = emulate(ws_url, args.get("emulation") or {}, hold=True)
-        if failure is not None:
-            print(json.dumps({"unavailable": failure, "applied": applied or []}), flush=True)
+        # Prints its announce line, then stays attached (and attaches to every later page target)
+        # until killed.
+        hold(port, page, args.get("emulation") or {})
         return
     if mode == "fidelity":
         result = evaluate(ws_url, FIDELITY_EXPRESSION) if ws_url else None
@@ -300,7 +428,7 @@ def main():
         title = result["title"] if isinstance(result.get("title"), str) else title
         text = result["text"] if isinstance(result.get("text"), str) else ""
         scroll_y = result["scrollY"] if isinstance(result.get("scrollY"), (int, float)) else None
-    print(json.dumps({"url": url, "title": title, "text": text, "scrollY": scroll_y}))
+    print(json.dumps({"url": url, "title": title, "text": text, "scrollY": scroll_y, "targetId": str(page.get("id") or "")}))
 
 main()
 `;

package/dist/chrome-cdp-probe.js.map

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

package/dist/cua-actor-lab.d.ts

@@ -685,7 +685,26 @@ export interface ChromeCdpEndpoint {
  * The observer still degrades to `{}` for the loop; the callback is how a lane says out loud that
  * url/text criteria are not being measured, instead of letting the funnel report 0/N (#514).
  */
-export declare function makeChromeBrowserStateObserver(desktop: E2BDesktopSandbox, requestTimeoutMs: number, endpoint: ChromeCdpEndpoint, targetId?: string, onUnavailable?: (reason: string) => void): () => Promise<{
+export declare function makeChromeBrowserStateObserver(desktop: E2BDesktopSandbox, requestTimeoutMs: number, endpoint: ChromeCdpEndpoint, targetId?: string, onUnavailable?: (reason: string) => void, 
+/**
+ * Mobile emulation on later tabs (#623): the holder attaches to every page target Chrome opens
+ * after the launch page, so a tab the participant opens later should lay out at the phone width
+ * too. The first observation on each new target reads that page's OWN report; a target that
+ * reports the requested width is recorded through `onCovered`, and one that does not (or cannot
+ * be read) fires `onDrift` once, so a phone-labelled lane that spent part of its session at
+ * desktop layout says so with the number the page gave.
+ */
+drift?: {
+    emulatedTargetId: string;
+    expectedWidth: number;
+    expectTouch?: boolean;
+    onDrift: (reason: string) => void;
+    onCovered?: (targetId: string, read: {
+        innerWidth: number;
+        devicePixelRatio: number;
+        maxTouchPoints: number;
+    }) => void;
+}): () => Promise<{
     url?: string;
     title?: string;
     text?: string;
@@ -712,6 +731,8 @@ export declare const DEFAULT_MOBILE_USER_AGENT = "Mozilla/5.0 (iPhone; CPU iPhon
 export declare function applyMobileEmulation(desktop: E2BDesktopSandbox, requestTimeoutMs: number, endpoint: ChromeCdpEndpoint, targetId: string | undefined, request: ChromeMobileEmulationRequest): Promise<{
     fidelity: NonNullable<RunDesktopGeometry["fidelity"]>;
     warnings: string[];
+    targetId?: string;
+    holderName: string;
 }>;
 /** Shared hosted-browser geometry capture used by per-lane and sequential shared-world routes. */
 export declare function captureDesktopBrowserGeometry(args: {