humanish 0.75.0 → 0.76.0

package/README.md

@@ -53,12 +53,14 @@ 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, receipts in `bench/` and `docs/goals/`):** 29 of 30 planted
-defects over two benchmark runs on an app we wrote, none invented on the clean arm; on two apps we
-did not write, 16 of 18 distinct findings confirmed against the source and 0 invented, across 14
-participants; and a modal that stopped 2 of 3 keyboard-first participants, was reported by
-all 3, and was never mentioned by 3 mouse-driving newcomers. Each file states
-its own caveats.
+**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
+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
+keyboard-first participants and none of the others; and, on a phone-sized desktop, a drawDB
+relationship drag intercepted by a popover that both phone participants hit (one stopped) and no
+desktop participant reported. Each file states its own caveats.
 
 `try-live` studies a real public app so that your first live run works without
 configuring anything; point its `subject` at your own app once you have seen it
@@ -343,7 +345,8 @@ persisted evidence: screenshots, events, terminal tails). See
 | `humanish runs` | List local runs and latest pointers. |
 | `humanish export` | One self-contained `.html` of a run's Observer with screenshots inlined; verify and the share_ready gate run inside, `--local-only` watermarks a raw-screenshot bundle. |
 | `humanish stats` | Cost, outcome, and duration roll-ups across run history; `--lab`, `--since`. Estimates stay labelled; unknown costs count as unknown. |
-| `humanish feedback issue` | Print a public-safe GitHub issue draft without API mutation. |
+| `humanish feedback list` | List a run's draft state and every feedback candidate (one per participant finding), with the ids `--candidate` takes. |
+| `humanish feedback issue` | Print a public-safe GitHub issue draft without API mutation. `--candidate <id>` chooses which finding; default is the first. |
 | `humanish lab run oss` | Repo-maintainer contract example: dry-run Observer-of-Observers for authorized repo selections. |
 | `humanish lab run oss-smoke` | Repo-maintainer dogfood example: disposable clone smoke test against public OSS repos. |
 
@@ -463,12 +466,26 @@ viewport is smaller because browser chrome occupies space; Chromium-family live
 measure it through CDP and record it separately from requested/verified screen geometry.
 Browsers without that measurement seam omit the viewport rather than guessing. A
 site's width-based responsive CSS still fires, and the model is *told* its device in the
-prompt, matching how those sims run organic mobile lanes. There is no touch input, the
-device-pixel-ratio isn't rendered, and the user-agent stays desktop on this route; true
-touch/DPR/UA emulation arrives with the deterministic CDP actor. Device is run-wide
-today; per-*persona* device (N personas × devices) lands with fan-out.
+prompt, matching how those sims run organic mobile lanes. Without the block below there is no
+touch input, the device-pixel-ratio isn't rendered, and the user-agent stays desktop on this
+route. Device is run-wide today; per-*persona* device (N personas × devices) lands with fan-out.
 `execution.desktop.resolution` is a raw escape hatch that overrides the preset.
 
+**Mobile emulation.** `execution.desktop.fidelity: { mobileEmulation: true }` turns every hosted
+Chrome/Chromium computer-use lane on a mobile preset (`mobile`, `small-mobile`, `narrow-mobile`)
+into a mobile-emulated browser before the participant arrives, and leaves desktop, tablet and
+wide lanes in the same run untouched: the lane's preset width/height become the CSS viewport (414 px for `mobile`, where the
+X screen itself cannot go below 500), the preset's device pixel ratio applies (`deviceScaleFactor`
+overrides it), touch events are on (`touch: false` turns them off) and the browser presents a
+mobile user agent (`userAgent` replaces the default iPhone Safari string). The run bundle records
+`desktopGeometry.fidelity` with `tier: mobile-emulated`, the request, the CDP methods applied,
+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.
+
 **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`,
 or `firefox`. A concrete value means "launch this browser or fail"; it never silently

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

@@ -18,8 +18,34 @@ export interface ChromeCdpProbeArgs {
      * funnel read reach-dashboard 0/2 under a screenshot OF the dashboard).
      */
     prefer?: ChromeCdpPagePreference;
-    /** "state": url/title/text/scrollY. "geometry": outer window + CSS viewport. "port": resolution only. */
-    mode: "state" | "geometry" | "port";
+    /**
+     * "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
+     * back what the page reports about itself (UA, DPR, viewport, touch), the proof for the bundle.
+     */
+    mode: "state" | "geometry" | "port" | "emulate" | "hold" | "fidelity";
+    /** For "emulate": what to apply. */
+    emulation?: ChromeMobileEmulationRequest;
+}
+/** Mobile emulation request (#221): the CDP Emulation domain applied to one page target. */
+export interface ChromeMobileEmulationRequest {
+    width: number;
+    height: number;
+    deviceScaleFactor: number;
+    touch: boolean;
+    userAgent: string;
+    platform?: string;
+}
+/** What the page reports after emulation: the proof, never copied from the request. */
+export interface ChromeFidelityRead {
+    userAgent: string;
+    devicePixelRatio: number;
+    innerWidth: number;
+    innerHeight: number;
+    maxTouchPoints: number;
+    coarsePointer: boolean;
 }
 /** The probe's stdout, before the caller narrows it. */
 export interface ChromeCdpProbeResult {
@@ -41,6 +67,10 @@ export interface ChromeCdpProbeResult {
         height: number;
         deviceScaleFactor: number;
     };
+    /** "emulate": the CDP methods that returned without error, in order. */
+    applied?: string[];
+    /** "fidelity": the read-back. */
+    fidelity?: ChromeFidelityRead;
 }
 /**
  * The probe itself. Kept as one string so the shipped command is exactly what the tests execute

package/dist/chrome-cdp-probe.js

@@ -28,7 +28,7 @@
  * a loopback read.
  */
 export const CHROME_CDP_PROBE_PY = String.raw `
-import base64, json, os, re, socket, struct, sys, urllib.request
+import base64, json, os, re, socket, struct, sys, time, urllib.request
 
 def resolve_port(args):
     port = args.get("cdpPort")
@@ -73,7 +73,9 @@ def select_page(pages, args):
         return match
     return http_pages[0] if len(http_pages) == 1 else None
 
-def evaluate(ws_url, expression, timeout=1.5):
+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
@@ -97,25 +99,6 @@ def evaluate(ws_url, expression, timeout=1.5):
         head, buffer = buffer.split(b"\r\n\r\n", 1)
         if b" 101 " not in head.split(b"\r\n", 1)[0]:
             return None
-        payload = json.dumps({
-            "id": 1,
-            "method": "Runtime.evaluate",
-            "params": {"returnByValue": True, "expression": expression},
-        }).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))
-
         state = {"buffer": buffer}
 
         def need(count):
@@ -125,42 +108,73 @@ def evaluate(ws_url, expression, timeout=1.5):
                     raise EOFError("socket closed")
                 state["buffer"] += chunk
 
-        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:
-                return None
-            if opcode in (9, 10):
-                continue
-            message += data
-            if fin:
-                try:
-                    reply = json.loads(message.decode("utf-8"))
-                except Exception:
+        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 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:
                     return None
-                message = b""
-                if isinstance(reply, dict) and reply.get("id") == 1:
-                    result = reply.get("result") or {}
-                    inner = result.get("result") if isinstance(result, dict) else None
-                    return inner.get("value") if isinstance(inner, dict) else 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
+
+        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
     except Exception:
         return None
     finally:
@@ -170,6 +184,14 @@ def evaluate(ws_url, expression, timeout=1.5):
             except Exception:
                 pass
 
+def evaluate(ws_url, expression, timeout=1.5):
+    replies = ws_session(ws_url, [{"method": "Runtime.evaluate", "params": {"returnByValue": True, "expression": expression}}], timeout)
+    if not replies or not isinstance(replies[0], dict):
+        return None
+    result = replies[0].get("result") or {}
+    inner = result.get("result") if isinstance(result, dict) else None
+    return inner.get("value") if isinstance(inner, dict) else None
+
 STATE_EXPRESSION = (
     "({ url: location.href, title: document.title, "
     "text: (document.body && document.body.innerText || '').slice(0, 20000), "
@@ -179,6 +201,46 @@ GEOMETRY_EXPRESSION = (
     "({ browserWindow: { x: window.screenX, y: window.screenY, width: window.outerWidth, height: window.outerHeight }, "
     "viewport: { width: window.innerWidth, height: window.innerHeight, deviceScaleFactor: window.devicePixelRatio } })"
 )
+FIDELITY_EXPRESSION = (
+    "({ userAgent: navigator.userAgent, devicePixelRatio: window.devicePixelRatio, "
+    "innerWidth: window.innerWidth, innerHeight: window.innerHeight, "
+    "maxTouchPoints: navigator.maxTouchPoints || 0, "
+    "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."""
+    width = int(request.get("width") or 0)
+    height = int(request.get("height") or 0)
+    scale = float(request.get("deviceScaleFactor") or 1)
+    user_agent = str(request.get("userAgent") or "")
+    platform = str(request.get("platform") or "")
+    messages = [
+        {"method": "Emulation.setDeviceMetricsOverride", "params": {
+            "width": width, "height": height, "deviceScaleFactor": scale, "mobile": True,
+            "screenWidth": width, "screenHeight": height}},
+    ]
+    if request.get("touch"):
+        messages.append({"method": "Emulation.setTouchEmulationEnabled", "params": {"enabled": True, "maxTouchPoints": 5}})
+        messages.append({"method": "Emulation.setEmitTouchEventsForMouse", "params": {"enabled": True, "configuration": "mobile"}})
+    if user_agent:
+        params = {"userAgent": user_agent}
+        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"
+    applied = []
+    for message, reply in zip(messages, replies):
+        if isinstance(reply, dict) and "error" not in reply:
+            applied.append(message["method"])
+        else:
+            detail = (reply or {}).get("error", {}).get("message") if isinstance(reply, dict) else "no reply"
+            return applied, "%s failed: %s" % (message["method"], detail)
+    return applied, None
 
 def main():
     args = json.loads(sys.argv[1]) if len(sys.argv) > 1 else {}
@@ -197,6 +259,29 @@ def main():
         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")
+    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:
+            print(json.dumps({"unavailable": failure, "applied": applied or []}))
+            return
+        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)
+        return
+    if mode == "fidelity":
+        result = evaluate(ws_url, FIDELITY_EXPRESSION) if ws_url else None
+        if not isinstance(result, dict):
+            print(json.dumps({"unavailable": "Runtime.evaluate over the page socket returned nothing"}))
+            return
+        print(json.dumps({"fidelity": result, "targetId": str(page.get("id") or "")}))
+        return
     if mode == "geometry":
         result = evaluate(ws_url, GEOMETRY_EXPRESSION) if ws_url else None
         if not isinstance(result, dict):
@@ -233,6 +318,8 @@ export function chromeCdpProbeCommand(args) {
         payload.targetId = args.targetId;
     if (args.prefer !== undefined)
         payload.prefer = args.prefer;
+    if (args.emulation !== undefined)
+        payload.emulation = args.emulation;
     return `python3 -c ${shellSingleQuote(CHROME_CDP_PROBE_PY)} ${shellSingleQuote(JSON.stringify(payload))}`;
 }
 /**
@@ -254,8 +341,12 @@ export function parseChromeCdpProbeOutput(stdout) {
     if (!parsed || typeof parsed !== "object")
         return { unavailable: "probe output was not an object" };
     const record = parsed;
-    if (typeof record.unavailable === "string")
-        return { unavailable: record.unavailable };
+    const applied = Array.isArray(record.applied)
+        ? record.applied.filter((item) => typeof item === "string")
+        : undefined;
+    if (typeof record.unavailable === "string") {
+        return { unavailable: record.unavailable, ...(applied === undefined ? {} : { applied }) };
+    }
     const numberOr = (value) => typeof value === "number" && Number.isFinite(value) ? value : undefined;
     const box = (value, keys) => {
         if (!value || typeof value !== "object")
@@ -274,7 +365,23 @@ export function parseChromeCdpProbeOutput(stdout) {
     const viewport = box(record.viewport, ["width", "height", "deviceScaleFactor"]);
     const cdpPort = numberOr(record.cdpPort);
     const scrollY = numberOr(record.scrollY);
+    const fidelity = (() => {
+        const raw = record.fidelity;
+        if (!raw || typeof raw !== "object")
+            return undefined;
+        const source = raw;
+        const dpr = numberOr(source.devicePixelRatio);
+        const innerWidth = numberOr(source.innerWidth);
+        const innerHeight = numberOr(source.innerHeight);
+        const maxTouchPoints = numberOr(source.maxTouchPoints);
+        if (typeof source.userAgent !== "string" || dpr === undefined || innerWidth === undefined || innerHeight === undefined || maxTouchPoints === undefined) {
+            return undefined;
+        }
+        return { userAgent: source.userAgent, devicePixelRatio: dpr, innerWidth, innerHeight, maxTouchPoints, coarsePointer: source.coarsePointer === true };
+    })();
     return {
+        ...(applied === undefined ? {} : { applied }),
+        ...(fidelity === undefined ? {} : { fidelity }),
         ...(cdpPort === undefined ? {} : { cdpPort }),
         ...(typeof record.url === "string" && record.url.length > 0 ? { url: record.url } : {}),
         ...(typeof record.title === "string" && record.title.length > 0 ? { title: record.title } : {}),

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":"AAAA,4FAA4F;AAC5F,EAAE;AACF,iGAAiG;AACjG,8FAA8F;AAC9F,8FAA8F;AAC9F,kGAAkG;AAClG,0FAA0F;AAC1F,kGAAkG;AAClG,gGAAgG;AAChG,mGAAmG;AACnG,oDAAoD;AACpD,EAAE;AACF,kGAAkG;AAClG,4FAA4F;AAC5F,EAAE;AACF,8EAA8E;AAC9E,kGAAkG;AAClG,gGAAgG;AAChG,iEAAiE;AAwCjE;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,MAAM,CAAC,GAAG,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA+L5C,CAAC;AAEF,SAAS,gBAAgB,CAAC,KAAa;IACrC,OAAO,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC;AAC7C,CAAC;AAED,4DAA4D;AAC5D,MAAM,UAAU,qBAAqB,CAAC,IAAwB;IAC5D,MAAM,OAAO,GAA4B,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC;IACxF,IAAI,IAAI,CAAC,OAAO,KAAK,SAAS;QAAE,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;IAC/D,IAAI,IAAI,CAAC,UAAU,KAAK,SAAS;QAAE,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,UAAU,CAAC;IACxE,IAAI,IAAI,CAAC,QAAQ,KAAK,SAAS;QAAE,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC;IAClE,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS;QAAE,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;IAC5D,OAAO,cAAc,gBAAgB,CAAC,mBAAmB,CAAC,IAAI,gBAAgB,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC;AAC5G,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,yBAAyB,CAAC,MAA0B;IAClE,MAAM,OAAO,GAAG,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IACtC,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,WAAW,EAAE,uBAAuB,EAAE,CAAC;IAC1E,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAC/B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,WAAW,EAAE,2BAA2B,EAAE,CAAC;IACtD,CAAC;IACD,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ;QAAE,OAAO,EAAE,WAAW,EAAE,gCAAgC,EAAE,CAAC;IACpG,MAAM,MAAM,GAAG,MAAiC,CAAC;IACjD,IAAI,OAAO,MAAM,CAAC,WAAW,KAAK,QAAQ;QAAE,OAAO,EAAE,WAAW,EAAE,MAAM,CAAC,WAAW,EAAE,CAAC;IACvF,MAAM,QAAQ,GAAG,CAAC,KAAc,EAAsB,EAAE,CACtD,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;IAC1E,MAAM,GAAG,GAAG,CAAC,KAAc,EAAE,IAAc,EAAsC,EAAE;QACjF,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;YAAE,OAAO,SAAS,CAAC;QAC1D,MAAM,MAAM,GAAG,KAAgC,CAAC;QAChD,MAAM,GAAG,GAA2B,EAAE,CAAC;QACvC,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;YACvB,MAAM,CAAC,GAAG,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;YAChC,IAAI,CAAC,KAAK,SAAS;gBAAE,OAAO,SAAS,CAAC;YACtC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACf,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC,CAAC;IACF,MAAM,aAAa,GAAG,GAAG,CAAC,MAAM,CAAC,aAAa,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,OAAO,EAAE,QAAQ,CAAC,CAA0C,CAAC;IACxH,MAAM,QAAQ,GAAG,GAAG,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC,OAAO,EAAE,QAAQ,EAAE,mBAAmB,CAAC,CAAqC,CAAC;IACpH,MAAM,OAAO,GAAG,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACzC,MAAM,OAAO,GAAG,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACzC,OAAO;QACL,GAAG,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC;QAC7C,GAAG,CAAC,OAAO,MAAM,CAAC,GAAG,KAAK,QAAQ,IAAI,MAAM,CAAC,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACvF,GAAG,CAAC,OAAO,MAAM,CAAC,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC/F,GAAG,CAAC,OAAO,MAAM,CAAC,IAAI,KAAK,QAAQ,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC3F,GAAG,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC;QAC7C,GAAG,CAAC,OAAO,MAAM,CAAC,QAAQ,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC3G,GAAG,CAAC,aAAa,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,CAAC;QACzD,GAAG,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC;KAChD,CAAC;AACJ,CAAC"}
+{"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

@@ -10,6 +10,7 @@ import { type E2BDesktopModule, type E2BDesktopSandbox } from "./e2b-desktop-lau
 import { type DetachedTimers } from "./e2b-detached.js";
 import { type DevicePreset } from "./device-presets.js";
 import { type LabActorLane, type LabCommsEmail, type LabCommsRecipient, type LabConfig, type LabDesktopBrowser, type LabSubjectServe, type LabSubjectState } from "./lab-config.js";
+import { type ChromeMobileEmulationRequest } from "./chrome-cdp-probe.js";
 import { type ResolvedPersona } from "./persona.js";
 import { type LabTask } from "./tasks.js";
 import { renderObserver, type ObserverResult } from "./observer.js";
@@ -700,6 +701,18 @@ export declare function makeChromeBrowserStateObserver(desktop: E2BDesktopSandbo
 export declare function makeChromeDesktopGeometryObserver(desktop: E2BDesktopSandbox, requestTimeoutMs: number, endpoint: ChromeCdpEndpoint, targetId?: string, onUnavailable?: (reason: string) => void): () => Promise<(Pick<RunDesktopGeometry, "browserWindow" | "viewport"> & {
     targetId?: string;
 }) | undefined>;
+/** The user agent a mobile-emulated lane presents unless the lab sets its own. */
+export declare const DEFAULT_MOBILE_USER_AGENT = "Mozilla/5.0 (iPhone; CPU iPhone OS 17_0 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/17.0 Mobile/15E148 Safari/604.1";
+/**
+ * Apply mobile emulation (#221) to the lane's launch page and read back what the page reports.
+ * Fails CLOSED: a request that cannot be applied throws, because a desktop run labelled mobile is
+ * the over-trust this feature exists to prevent. A read-back that cannot be taken is a warning
+ * (the emulation was applied; only the proof is missing).
+ */
+export declare function applyMobileEmulation(desktop: E2BDesktopSandbox, requestTimeoutMs: number, endpoint: ChromeCdpEndpoint, targetId: string | undefined, request: ChromeMobileEmulationRequest): Promise<{
+    fidelity: NonNullable<RunDesktopGeometry["fidelity"]>;
+    warnings: string[];
+}>;
 /** Shared hosted-browser geometry capture used by per-lane and sequential shared-world routes. */
 export declare function captureDesktopBrowserGeometry(args: {
     desktop: E2BDesktopSandbox;