@vostride/agent-qa-web 0.2.2 → 0.2.4

package/dist/index.js

@@ -1,88 +1,13 @@
 // src/adapter.ts
+import { DEFAULT_NAVIGATION_TIMEOUT_MS } from "@vostride/agent-qa-schema";
 import {
   assertNever,
-  buildScreenState as buildScreenState3,
+  buildScreenState as buildScreenState2,
   createSnapshotLiveStream,
   LIVE_KEEPALIVE_QUIET_MS
 } from "@vostride/agent-qa-runner";
 import { convertKeysForPlatform, isMacPlatform } from "@vostride/agent-qa-runner";
 
-// src/observer.ts
-import { buildScreenState } from "@vostride/agent-qa-runner";
-
-// src/dom-extractor.ts
-var SKIP_TAGS = /* @__PURE__ */ new Set([
-  "SCRIPT",
-  "STYLE",
-  "SVG",
-  "NOSCRIPT",
-  "LINK",
-  "META",
-  "TEMPLATE",
-  "IFRAME"
-]);
-function extractDomTree(opts) {
-  const { maxDepth, maxTextLen } = opts;
-  const doc = globalThis.document;
-  const win = globalThis.window;
-  const lines = [];
-  function isHidden(el) {
-    if (!el.offsetParent && el.tagName !== "BODY" && el.tagName !== "HTML") {
-      const style = win.getComputedStyle(el);
-      if (style.display === "none" || style.visibility === "hidden") return true;
-    }
-    return false;
-  }
-  function walk(node, depth, indent) {
-    if (depth > maxDepth) {
-      lines.push(indent + "[... deeper content truncated]");
-      return;
-    }
-    for (let child = node.firstChild; child; child = child.nextSibling) {
-      if (child.nodeType === 3) {
-        const text = child.textContent.trim();
-        if (text) {
-          const truncated = text.length > maxTextLen ? text.slice(0, maxTextLen) + "..." : text;
-          lines.push(indent + truncated);
-        }
-        continue;
-      }
-      if (child.nodeType !== 1) continue;
-      const tag = child.tagName;
-      if (SKIP_TAGS.has(tag)) continue;
-      if (isHidden(child)) continue;
-      const isCustom = tag.toLowerCase().includes("-");
-      const annotation = child.getAttribute("aria-label") || child.getAttribute("role") || "";
-      let label = tag.toLowerCase();
-      if (isCustom) {
-        if (!child.shadowRoot && !child.firstChild) {
-          label += " (custom element, closed shadow root)";
-        } else {
-          label += " (custom element)";
-        }
-      }
-      if (annotation) label += ` [${annotation}]`;
-      lines.push(indent + label);
-      if (child.shadowRoot) {
-        lines.push(indent + "  #shadow-root");
-        walk(child.shadowRoot, depth + 1, indent + "    ");
-      }
-      walk(child, depth + 1, indent + "  ");
-    }
-  }
-  walk(doc.body, 0, "");
-  return lines.join("\n");
-}
-async function extractDom(page, opts) {
-  const maxDepth = opts?.maxDepth ?? 20;
-  const maxTextLen = opts?.maxTextLen ?? 200;
-  try {
-    return await page.evaluate(extractDomTree, { maxDepth, maxTextLen });
-  } catch {
-    return void 0;
-  }
-}
-
 // src/observer.ts
 var INTERACTIVE_ROLES = /* @__PURE__ */ new Set([
   "button",
@@ -203,20 +128,6 @@ function parseAriaSnapshot(ariaTree) {
   }
   return { nodes, nativeRefs };
 }
-function hideAgentQaElements() {
-  const doc = globalThis.document;
-  doc.querySelectorAll("[data-agent-qa-internal]").forEach((el) => {
-    el.style.display = "none";
-    el.setAttribute("aria-hidden", "true");
-  });
-}
-function restoreAgentQaElements() {
-  const doc = globalThis.document;
-  doc.querySelectorAll("[data-agent-qa-internal]").forEach((el) => {
-    el.style.display = "";
-    el.removeAttribute("aria-hidden");
-  });
-}
 async function captureWebScroll(page) {
   const fallbackViewport = page.viewportSize() ?? { width: 0, height: 0 };
   try {
@@ -343,41 +254,6 @@ function coerceBounds(value) {
 function coerceString(value) {
   return typeof value === "string" && value.length > 0 ? value : void 0;
 }
-async function observePage(page, options) {
-  const locator = options?.filterSelector ? page.locator(options.filterSelector) : page.locator(":root");
-  await page.evaluate(hideAgentQaElements);
-  let ariaTree;
-  try {
-    ariaTree = await locator.ariaSnapshot();
-  } finally {
-    await page.evaluate(restoreAgentQaElements);
-  }
-  const timestamp = Date.now();
-  const url = page.url();
-  const { viewport: capturedViewport, scroll } = await captureWebScroll(page);
-  let domContext;
-  if (options?.extractDom) {
-    try {
-      domContext = await extractDom(page);
-    } catch {
-    }
-  }
-  const { nodes, nativeRefs } = ariaTree ? parseAriaSnapshot(ariaTree) : { nodes: [], nativeRefs: [] };
-  if (nodes.length > 0) {
-    await enrichWebNodes(page, nodes, nativeRefs);
-  }
-  const { state } = buildScreenState({
-    platform: "web",
-    nodes,
-    viewport: capturedViewport,
-    scroll,
-    coordSpace: "viewport",
-    timestamp,
-    url,
-    ...domContext ? { domContext } : {}
-  });
-  return state;
-}
 function numberOr(value, fallback) {
   return typeof value === "number" && Number.isFinite(value) ? value : fallback;
 }
@@ -432,7 +308,7 @@ var ElementResolver = class {
 };
 
 // src/binding.ts
-import { buildScreenState as buildScreenState2, rowTextOf as rowTextOf2 } from "@vostride/agent-qa-runner";
+import { buildScreenState, rowTextOf as rowTextOf2 } from "@vostride/agent-qa-runner";
 var BINDING_LANES = ["ref", "fromRef", "toRef"];
 var FRAME_REF = /^f\d+e/;
 var INVALID_FRAME = /invalid frame/i;
@@ -442,14 +318,14 @@ var WHAT_CHANGED = {
   "binding-lost": "the observed element is no longer on the page",
   "binding-changed": "the observed element now has a different role, name or row"
 };
-function hideAgentQaElements2() {
+function hideAgentQaElements() {
   const doc = globalThis.document;
   doc.querySelectorAll("[data-agent-qa-internal]").forEach((el) => {
     el.style.display = "none";
     el.setAttribute("aria-hidden", "true");
   });
 }
-function restoreAgentQaElements2() {
+function restoreAgentQaElements() {
   const doc = globalThis.document;
   doc.querySelectorAll("[data-agent-qa-internal]").forEach((el) => {
     el.style.display = "";
@@ -458,7 +334,7 @@ function restoreAgentQaElements2() {
 }
 async function snapshotRoot(page, options = {}) {
   const { timeoutMs, retryTimeoutMs } = options;
-  await page.evaluate(hideAgentQaElements2);
+  await page.evaluate(hideAgentQaElements);
   try {
     if (timeoutMs === void 0) return await page.locator(":root").ariaSnapshot({ mode: "ai" });
     return await page.locator(":root").ariaSnapshot({ mode: "ai", timeout: timeoutMs }).catch((error) => {
@@ -469,7 +345,7 @@ async function snapshotRoot(page, options = {}) {
       });
     });
   } finally {
-    await page.evaluate(restoreAgentQaElements2);
+    await page.evaluate(restoreAgentQaElements);
   }
 }
 async function captureEpoch(page) {
@@ -515,7 +391,7 @@ async function checkBinding(page, epoch, entry, snapshot) {
     const detached = await frameDetached(page, entry.nativeRef);
     return { outcome: detached ? "frame-detached" : "binding-lost" };
   }
-  const { state } = buildScreenState2({
+  const { state } = buildScreenState({
     platform: "web",
     nodes,
     viewport: { width: 0, height: 0 },
@@ -1319,7 +1195,6 @@ function createScreencastRecording(getPage, config, getPageRevision) {
       const before = scene;
       const epoch = firstFrameEpoch;
       const revision = sceneRevision;
-      if (!getPageRevision) return void 0;
       const pageRevision = getPageRevision();
       if (!recording || !before || epoch === void 0 || getPage() !== recording.page) return void 0;
       const viewport = recording.page.viewportSize();
@@ -1450,8 +1325,7 @@ var CLIPBOARD_HOOK = `(() => {
     if (typeof send !== 'function' || typeof text !== 'string' || text.length === 0) return;
     try { Promise.resolve(send({ via, text })).catch(() => {}); } catch {}
   };
-  // 2026-10-08 (436-14): a write is reported only once the browser accepted it; the app still
-  // gets the original promise, rejections included.
+  // A write is reported only once the browser accepted it; the app gets the original promise.
   const proto = typeof Clipboard === 'function' ? Clipboard.prototype : undefined;
   if (proto && typeof proto.writeText === 'function') {
     const writeText = proto.writeText;
@@ -1532,7 +1406,7 @@ var OperationCapture = class {
   downloads = [];
   /** Downloads that started while no start window was open, kept for the next action. */
   held = [];
-  /** Completed downloads' bytes by sha256, oldest first; memory only (439 D-04). */
+  /** Completed downloads' bytes by sha256, oldest first; memory only. */
   heldBytes = /* @__PURE__ */ new Map();
   heldByteTotal = 0;
   pendingNavigations = /* @__PURE__ */ new Map();
@@ -2041,41 +1915,34 @@ var WebPlatformAdapter = class {
   browser = null;
   context = null;
   page = null;
-  // The native binding of the last observation and its document (438 D-06). Neither crosses the
-  // port (observe returns only the ScreenState).
+  // Adapter-private: observe returns only the `ScreenState`, never the native binding.
   lastRefs = {};
   epoch;
   pageLogBuffers = /* @__PURE__ */ new Map();
   logCaptureConfig = { console: true, network: true };
+  navigationTimeoutMs = DEFAULT_NAVIGATION_TIMEOUT_MS;
   disconnected = false;
   intentionalClose = false;
-  // Persistent route interception + one-shot dialog arms live until an explicit unroute or
-  // test teardown (D-12/D-18); cleanup() drains both so nothing bleeds across tests (Pitfall 7).
+  // Routes persist until unroute and a dialog arm until its dialog; `cleanup()` drains both.
   armedRoutes = /* @__PURE__ */ new Set();
   pendingDialogArm = null;
-  // 403 D-05: the live screencast's CDP session, owned here and never handed out.
   browserName = "chromium";
   screencast = null;
   screencastCapability = null;
   recordingCapability;
   recordingPageRevision = 0;
   recordingConfig;
-  // 403-02: the PRODUCT's frame identity, and the CDP ack token it maps to. See `liveStream`.
   screencastFrameSeq = 0;
   screencastAckTokens = /* @__PURE__ */ new Map();
-  // 428 D-15: the running screencast's consumer, its quiet-page keepalive, and the size a keepalive
-  // frame reports (the last screencast frame's device size).
   screencastOnFrame = null;
   keepaliveTimer = null;
   lastScreencastSize = null;
   keepaliveEchoDeadline = null;
   screencastChain = Promise.resolve();
-  // 428 D-12: the labelled snapshot preview standing in for a screencast withdrawn mid-stream.
   withdrawnSnapshot = null;
   screencastRecoveryTimer = null;
-  // 436 D-19, D-21: download and app-clipboard capture, Chromium only; armed around each execute().
   operationCapture = null;
-  // 436 D-23: Firefox and WebKit run no capture and name themselves as the reason.
+  // Firefox and WebKit run no capture and name themselves as the reason.
   operationCaptureSupport;
   async setup(config) {
     this.recordingConfig = config.recording;
@@ -2111,6 +1978,8 @@ var WebPlatformAdapter = class {
       contextOptions.storageState = config.authState.storageStatePath;
     }
     this.context = await this.browser.newContext(contextOptions);
+    this.navigationTimeoutMs = config.timeouts?.navigation ?? DEFAULT_NAVIGATION_TIMEOUT_MS;
+    this.context.setDefaultNavigationTimeout(this.navigationTimeoutMs);
     if (browserName === "chromium") {
       await this.context.grantPermissions(["clipboard-write"]);
     }
@@ -2128,22 +1997,7 @@ var WebPlatformAdapter = class {
       this.operationCaptureSupport = { download: false, clipboard: false, reason: browserName };
     }
   }
-  /**
-   * 403 D-05/LIVE-01: the Chromium screencast producer, or ABSENT when this adapter cannot stream.
-   *
-   * Absence means "no continuous stream", not "no preview": since 428-05 the composition's
-   * `liveStreamFor` wraps this adapter's `screenshot()` in the labelled 1 s snapshot producer, both
-   * as the fallback behind a screencast that fails to start and as the whole preview on a
-   * non-Chromium target. The two gates here (Chromium only, and a page to stream) stay exactly as
-   * they are, so the absence stays honest.
-   *
-   * SCOPE (428 D-18, closes WIN #273): the screencast shows the page the test is acting on. Both
-   * page-switch sites (`tab new`, `tab switch`) go through `setActivePage`, which re-binds the
-   * running screencast to the new page INSIDE this same capability object: no stop, no re-register,
-   * no stream end, so a subscriber only sees the picture change. Start, stop and re-bind run on one
-   * serialised chain. A popup or a closing tab never changes `this.page` in this adapter, so the
-   * preview already shows the acting page in those cases.
-   */
+  // Absence means no stream, not no preview: the runner's `liveStreamFor` wraps `screenshot()`.
   get liveStream() {
     if (this.browserName !== "chromium") return void 0;
     if (!this.page || !this.context) return void 0;
@@ -2193,7 +2047,7 @@ var WebPlatformAdapter = class {
     this.screencastCapability = capability;
     return capability;
   }
-  /** Run `step` after every earlier start, stop and re-bind has settled (428 D-18). */
+  /** Run `step` after every earlier start, stop and re-bind has settled. */
   onScreencastChain(step) {
     const run = this.screencastChain.then(step);
     this.screencastChain = run.catch(() => void 0);
@@ -2246,7 +2100,7 @@ var WebPlatformAdapter = class {
         metadata: {
           width: metadata.deviceWidth,
           height: metadata.deviceHeight,
-          // CDP's `TimeSinceEpoch` is SECONDS; every other layer reads epoch ms (428 D-15).
+          // CDP's `TimeSinceEpoch` is in seconds; every other layer uses epoch ms.
           ...metadata.timestamp === void 0 ? {} : { timestamp: Math.round(metadata.timestamp * 1e3) },
           scrollOffsetX: metadata.scrollOffsetX,
           scrollOffsetY: metadata.scrollOffsetY
@@ -2254,11 +2108,7 @@ var WebPlatformAdapter = class {
       });
     });
   }
-  /**
-   * The one place the page the test acts on changes (428 D-18). Recording keeps following its
-   * starting page through the revision counter (424 reconciliation 25(d)); the live screencast,
-   * when running, re-binds to the new page on the serialised chain.
-   */
+  // Every page switch goes through here so a running screencast re-binds on its chain.
   setActivePage(page) {
     this.page = page;
     this.recordingPageRevision++;
@@ -2304,14 +2154,7 @@ var WebPlatformAdapter = class {
     this.armKeepalive(cdp);
     await this.stopWithdrawnSnapshot();
   }
-  /**
-   * 428 D-12's second half: the screencast was withdrawn while the browser is still up (its CDP
-   * session detached or unusable), which only this capability can see. Detected when a keepalive
-   * capture or a re-bind's start rejects on the active session; the capability then serves the
-   * labelled 1 s snapshot preview of the current page through the same `onFrame`, until `stop()`,
-   * `cleanup()` or a successful re-bind. The declared kind stays `cdp-screencast`; the frames carry
-   * `kind: 'snapshot'`, which is what labels the preview. Runs on the serialised chain.
-   */
+  // Frames carry `kind: 'snapshot'` until a re-bind; the declared kind stays `cdp-screencast`.
   handleScreencastWithdrawn(cdp) {
     void this.onScreencastChain(async () => {
       if (this.screencast !== cdp) return;
@@ -2327,7 +2170,6 @@ var WebPlatformAdapter = class {
       this.armScreencastRecovery();
     });
   }
-  /** While the snapshot fallback runs, try the screencast again every SCREENCAST_RECOVERY_MS (428 WR-08). */
   armScreencastRecovery() {
     this.clearScreencastRecovery();
     const timer = setTimeout(() => {
@@ -2370,14 +2212,7 @@ var WebPlatformAdapter = class {
     timer.unref?.();
     this.keepaliveTimer = timer;
   }
-  /**
-   * 428 D-15: a fresh capture on the same CDP session, emitted as a frame with no ack token (the ack
-   * path drops ids it never minted a token for). A capture that rejects emits nothing. While the
-   * capability is started under a live browser, a session that then fails a trivial probe too is a
-   * withdrawn screencast (D-12, see `handleScreencastWithdrawn`); one that still answers only had a
-   * bad moment, such as a cross-process navigation, and re-arms (428 WR-08). One that never settles
-   * emits nothing and arms nothing, which is the honest amber.
-   */
+  // A rejected capture means a withdrawn screencast only if a trivial probe fails too.
   async fireKeepalive(cdp) {
     this.keepaliveTimer = null;
     if (this.screencast !== cdp) return;
@@ -2485,7 +2320,7 @@ var WebPlatformAdapter = class {
   get isBrowserDisconnected() {
     return this.disconnected;
   }
-  async observe(options) {
+  async observe() {
     if (!this.page) {
       throw new Error("WebPlatformAdapter not initialized \u2014 call setup() first");
     }
@@ -2493,7 +2328,7 @@ var WebPlatformAdapter = class {
     await waitForPageReady(page);
     const epoch = await captureEpoch(page);
     try {
-      const state = await this.observeDocument(page, options);
+      const state = await this.observeDocument(page);
       await disposeEpoch(this.epoch);
       this.epoch = epoch;
       return state;
@@ -2502,29 +2337,21 @@ var WebPlatformAdapter = class {
       throw error;
     }
   }
-  async observeDocument(page, options) {
+  async observeDocument(page) {
     const ariaTree = await snapshotRoot(page, OBSERVE_SNAPSHOT);
     const { nodes, nativeRefs } = parseAriaSnapshot(ariaTree);
     if (nodes.length > 0) {
       await enrichWebNodes(page, nodes, nativeRefs);
     }
     const { viewport, scroll } = await captureWebScroll(page);
-    let domContext;
-    if (options?.extractDom) {
-      try {
-        domContext = await extractDom(page);
-      } catch {
-      }
-    }
-    const { state, binding } = buildScreenState3({
+    const { state, binding } = buildScreenState2({
       platform: "web",
       nodes,
       viewport,
       scroll,
       coordSpace: "viewport",
       timestamp: Date.now(),
-      url: page.url(),
-      ...domContext !== void 0 ? { domContext } : {}
+      url: page.url()
     });
     this.lastRefs = buildRefMap(binding, nodes, nativeRefs, state.elements);
     return state;
@@ -2545,6 +2372,15 @@ var WebPlatformAdapter = class {
     }
     return withOperationMetadata(result, captured);
   }
+  // A navigation that timed out stays pending and blocks every later call on its page until stopped.
+  async stopLoading(page) {
+    try {
+      const cdp = await this.context.newCDPSession(page);
+      await cdp.send("Page.stopLoading");
+      await cdp.detach();
+    } catch {
+    }
+  }
   async executeWithErrorResult(action) {
     if (!this.page) {
       throw new Error("WebPlatformAdapter not initialized \u2014 call setup() first");
@@ -2607,7 +2443,6 @@ var WebPlatformAdapter = class {
     if (!urlPattern) return all;
     return all.filter((e) => e.url.includes(urlPattern));
   }
-  /** 439 D-04: a completed download's bytes held in memory, by its sha256. */
   readDownloadBytes(sha256) {
     return this.operationCapture?.readDownloadBytes(sha256);
   }
@@ -2630,8 +2465,9 @@ var WebPlatformAdapter = class {
     this.pageLogBuffers.set(page, buffers);
     if (this.logCaptureConfig.console) {
       page.on("console", (msg) => {
+        const type = msg.type();
         buffers.consoleLogs.push({
-          level: msg.type(),
+          level: type === "warning" ? "warn" : type,
           text: msg.text(),
           location: msg.location(),
           timestamp: Date.now()
@@ -2746,19 +2582,24 @@ var WebPlatformAdapter = class {
         return { success: true, boundingBox: box ?? void 0 };
       }
       case "navigate": {
-        switch (action.to) {
-          case "url":
-            await page.goto(action.url, { waitUntil: "domcontentloaded" });
-            break;
-          case "back":
-            await page.goBack({ waitUntil: "domcontentloaded" });
-            break;
-          case "forward":
-            await page.goForward({ waitUntil: "domcontentloaded" });
-            break;
-          case "reload":
-            await page.reload({ waitUntil: "domcontentloaded" });
-            break;
+        try {
+          switch (action.to) {
+            case "url":
+              await page.goto(action.url, { waitUntil: "domcontentloaded" });
+              break;
+            case "back":
+              await page.goBack({ waitUntil: "domcontentloaded" });
+              break;
+            case "forward":
+              await page.goForward({ waitUntil: "domcontentloaded" });
+              break;
+            case "reload":
+              await page.reload({ waitUntil: "domcontentloaded" });
+              break;
+          }
+        } catch (err) {
+          await this.stopLoading(page);
+          throw err;
         }
         await waitForPageReady(page);
         return { success: true };
@@ -2793,12 +2634,12 @@ var WebPlatformAdapter = class {
       }
       case "waitForUrl": {
         try {
-          await page.waitForURL(action.pattern, { timeout: 3e4 });
+          await page.waitForURL(action.pattern, { timeout: this.navigationTimeoutMs });
           return { success: true };
         } catch (err) {
           return {
             success: false,
-            error: `URL pattern "${action.pattern}" did not match within 30s. Hint: use "**" wildcards for substring matching (e.g., "**/dashboard**"). ${err instanceof Error ? err.message : String(err)}`
+            error: `URL pattern "${action.pattern}" did not match within ${this.navigationTimeoutMs}ms. Hint: use "**" wildcards for substring matching (e.g., "**/dashboard**"). ${err instanceof Error ? err.message : String(err)}`
           };
         }
       }
@@ -2864,7 +2705,12 @@ var WebPlatformAdapter = class {
         if (action.action === "new") {
           const newPage = await this.context.newPage();
           this.attachLogListeners(newPage);
-          await newPage.goto(action.url, { waitUntil: "domcontentloaded" });
+          try {
+            await newPage.goto(action.url, { waitUntil: "domcontentloaded" });
+          } catch (err) {
+            await this.stopLoading(newPage);
+            throw err;
+          }
           await waitForPageReady(newPage);
           this.setActivePage(newPage);
           return { success: true };
@@ -3006,9 +2852,6 @@ var WebPlatformAdapter = class {
             case "network":
               value = this.peekNetworkLogs();
               break;
-            case "expr-result":
-              value = void 0;
-              break;
           }
         }
         return { success: true, data: value };
@@ -3113,10 +2956,7 @@ var WebPlatformAdapter = class {
       case "executeScript": {
         return { success: false, error: "executeScript is a mobile-only action" };
       }
-      // Runner-minted / author-channel verbs (D-01/D-15/D-16): reportValue, uniqueValue, assertAI,
-      // extractAI, and setVariable are intercepted at the dispatch seam and never reach the adapter.
-      // A grouped §7.1 defensive case surfaces a dispatch-routing error if one arrives here;
-      // assertNever remains the backstop for a genuinely unknown schema verb.
+      // The dispatch seam intercepts these verbs; reaching the adapter is a routing error.
       case "reportValue":
       case "uniqueValue":
       case "assertAI":
@@ -3132,800 +2972,6 @@ var WebPlatformAdapter = class {
   }
 };
 
-// src/farm-adapter.ts
-import { assertNever as assertNever2, buildScreenState as buildScreenState4 } from "@vostride/agent-qa-runner";
-import { getProvider, registerAllProviders } from "@vostride/agent-qa-core";
-import { convertKeysForPlatform as convertKeysForPlatform2, isMacPlatform as isMacPlatform2 } from "@vostride/agent-qa-runner";
-function clickDelayOption2(clickDelay) {
-  return clickDelay !== void 0 && clickDelay > 0 ? { delay: clickDelay } : {};
-}
-function readSeamStorageState2(action) {
-  return action.state;
-}
-var FarmWebAdapter = class {
-  platform = "web";
-  browser = null;
-  context = null;
-  page = null;
-  // The native binding of the last observation and its document (438 D-06).
-  lastRefs = {};
-  epoch;
-  sessionUrl;
-  sessionId;
-  testFailed = false;
-  exitHandler = null;
-  credentials = null;
-  pageLogBuffers = /* @__PURE__ */ new Map();
-  logCaptureConfig = { console: true, network: true };
-  // Persistent route interception + one-shot dialog arms live until an explicit unroute or
-  // test teardown (D-12/D-18); cleanup() drains both so nothing bleeds across tests (Pitfall 7).
-  armedRoutes = /* @__PURE__ */ new Set();
-  pendingDialogArm = null;
-  recordingCapability;
-  recordingConfig;
-  async setup(config) {
-    this.recordingConfig = config.recording;
-    if (!config.farmSession) {
-      throw new Error("FarmWebAdapter requires config.farmSession to be set");
-    }
-    registerAllProviders();
-    const provider = getProvider("browserstack");
-    if (!provider) {
-      throw new Error("Unknown farm provider: browserstack");
-    }
-    this.credentials = provider.resolveCredentials(config.farmSession.capabilities);
-    if (!config.browser?.name) {
-      throw new Error("FarmWebAdapter requires config.browser.name to be set");
-    }
-    const credentials = this.credentials;
-    const farmWebConfig = {
-      browser: config.browser,
-      credentials,
-      testName: config.farmSession.capabilities?.testName
-    };
-    const { wsEndpoint } = await provider.resolveWebEndpoint(farmWebConfig);
-    const { chromium } = await import("playwright-core");
-    this.browser = await chromium.connect({ wsEndpoint });
-    const contextOptions = {
-      viewport: config.browser?.viewport ?? { width: 1280, height: 720 }
-    };
-    if (config.authState?.storageStatePath) {
-      contextOptions.storageState = config.authState.storageStatePath;
-    }
-    this.context = await this.browser.newContext(contextOptions);
-    await this.context.grantPermissions(["clipboard-write"]);
-    this.page = await this.context.newPage();
-    try {
-      const cdpSession = await this.page.context().newCDPSession(this.page);
-      const result = await cdpSession.send("Browser.getVersion");
-      await cdpSession.detach();
-      const auth = Buffer.from(`${credentials.username}:${credentials.accessKey}`).toString("base64");
-      const resp = await fetch("https://api.browserstack.com/automate/builds.json?limit=1&status=running", {
-        headers: { Authorization: `Basic ${auth}` }
-      });
-      if (resp.ok) {
-        const builds = await resp.json();
-        if (builds.length > 0) {
-          const buildId = builds[0].automation_build.hashed_id;
-          const sessResp = await fetch(`https://api.browserstack.com/automate/builds/${buildId}/sessions.json?limit=1`, {
-            headers: { Authorization: `Basic ${auth}` }
-          });
-          if (sessResp.ok) {
-            const sessions = await sessResp.json();
-            if (sessions.length > 0) {
-              this.sessionId = sessions[0].automation_session.hashed_id;
-              this.sessionUrl = sessions[0].automation_session.browser_url;
-            }
-          }
-        }
-      }
-    } catch {
-    }
-    this.exitHandler = () => {
-      try {
-        this.browser?.close();
-      } catch {
-      }
-    };
-    process.on("exit", this.exitHandler);
-    this.logCaptureConfig = { console: config.logCapture?.console !== false, network: config.logCapture?.network !== false };
-    this.attachLogListeners(this.page);
-  }
-  get recording() {
-    if (!this.page || !this.context || !this.recordingConfig) return void 0;
-    return this.recordingCapability ??= createScreencastRecording(
-      () => this.page,
-      this.recordingConfig
-    );
-  }
-  async cleanup() {
-    try {
-      await this.recordingCapability?.stop();
-    } catch {
-    }
-    this.recordingCapability = void 0;
-    this.recordingConfig = void 0;
-    if (this.context) {
-      try {
-        await this.context.unrouteAll({ behavior: "ignoreErrors" });
-      } catch {
-      }
-      try {
-        await this.context.setOffline(false);
-      } catch {
-      }
-    }
-    if (this.page && this.pendingDialogArm) {
-      try {
-        this.page.off("dialog", this.pendingDialogArm);
-      } catch {
-      }
-    }
-    this.armedRoutes.clear();
-    this.pendingDialogArm = null;
-    await disposeEpoch(this.epoch);
-    this.epoch = void 0;
-    if (this.browser) {
-      await this.browser.close();
-    }
-    if (this.sessionId && this.credentials) {
-      try {
-        const status = this.testFailed ? "failed" : "passed";
-        const reason = this.testFailed ? "Test failed" : "Test passed";
-        const auth = Buffer.from(`${this.credentials.username}:${this.credentials.accessKey}`).toString("base64");
-        await fetch(`https://api.browserstack.com/automate/sessions/${this.sessionId}.json`, {
-          method: "PUT",
-          headers: { Authorization: `Basic ${auth}`, "Content-Type": "application/json" },
-          body: JSON.stringify({ status, reason })
-        });
-      } catch {
-      }
-    }
-    if (this.exitHandler) {
-      process.removeListener("exit", this.exitHandler);
-      this.exitHandler = null;
-    }
-    this.browser = null;
-    this.context = null;
-    this.page = null;
-    this.lastRefs = {};
-    this.pageLogBuffers.clear();
-  }
-  async observe(options) {
-    if (!this.page) {
-      throw new Error("FarmWebAdapter not initialized \u2014 call setup() first");
-    }
-    const page = this.page;
-    await waitForPageReady(page);
-    const epoch = await captureEpoch(page);
-    try {
-      const state = await this.observeDocument(page, options);
-      await disposeEpoch(this.epoch);
-      this.epoch = epoch;
-      return state;
-    } catch (error) {
-      await disposeEpoch(epoch);
-      throw error;
-    }
-  }
-  async observeDocument(page, options) {
-    const ariaTree = await snapshotRoot(page);
-    const { nodes, nativeRefs } = parseAriaSnapshot(ariaTree);
-    if (nodes.length > 0) {
-      await enrichWebNodes(page, nodes, nativeRefs);
-    }
-    const { viewport, scroll } = await captureWebScroll(page);
-    let domContext;
-    if (options?.extractDom) {
-      try {
-        domContext = await extractDom(page);
-      } catch {
-      }
-    }
-    const { state, binding } = buildScreenState4({
-      platform: "web",
-      nodes,
-      viewport,
-      scroll,
-      coordSpace: "viewport",
-      timestamp: Date.now(),
-      url: page.url(),
-      ...domContext !== void 0 ? { domContext } : {}
-    });
-    this.lastRefs = buildRefMap(binding, nodes, nativeRefs, state.elements);
-    return state;
-  }
-  async execute(action) {
-    if (!this.page) {
-      throw new Error("FarmWebAdapter not initialized \u2014 call setup() first");
-    }
-    try {
-      return await this.executeAction(action);
-    } catch (err) {
-      let screenshot;
-      let boundingBox;
-      try {
-        screenshot = await this.page.screenshot();
-      } catch {
-      }
-      try {
-        if ("ref" in action && typeof action.ref === "string") {
-          const resolver = new ElementResolver(this.page, this.lastRefs);
-          const box = await resolver.getBoundingBox(action.ref);
-          if (box) boundingBox = box;
-        }
-      } catch {
-      }
-      return {
-        success: false,
-        error: err instanceof Error ? err.message : String(err),
-        screenshot,
-        boundingBox
-      };
-    }
-  }
-  async screenshot() {
-    try {
-      if (this.page) {
-        return await this.page.screenshot();
-      }
-      return void 0;
-    } catch {
-      return void 0;
-    }
-  }
-  getPage() {
-    return this.page;
-  }
-  markFailed() {
-    this.testFailed = true;
-  }
-  getSessionUrl() {
-    return this.sessionUrl;
-  }
-  getSessionId() {
-    return this.sessionId;
-  }
-  drainConsoleLogs(level) {
-    const all = [];
-    for (const buffers of this.pageLogBuffers.values()) {
-      const newLogs = buffers.consoleLogs.slice(buffers.consoleDrainIndex);
-      buffers.consoleDrainIndex = buffers.consoleLogs.length;
-      all.push(...newLogs);
-    }
-    if (!level) return all;
-    return all.filter((e) => e.level === level);
-  }
-  drainNetworkLogs(urlPattern) {
-    const all = [];
-    for (const buffers of this.pageLogBuffers.values()) {
-      const newLogs = buffers.networkLogs.slice(buffers.networkDrainIndex);
-      buffers.networkDrainIndex = buffers.networkLogs.length;
-      all.push(...newLogs);
-    }
-    if (!urlPattern) return all;
-    return all.filter((e) => e.url.includes(urlPattern));
-  }
-  peekNetworkLogs(urlPattern) {
-    const all = [];
-    for (const buffers of this.pageLogBuffers.values()) {
-      all.push(...buffers.networkLogs.slice(buffers.networkDrainIndex));
-    }
-    if (!urlPattern) return all;
-    return all.filter((e) => e.url.includes(urlPattern));
-  }
-  attachLogListeners(page) {
-    const buffers = {
-      consoleLogs: [],
-      networkLogs: [],
-      consoleDrainIndex: 0,
-      networkDrainIndex: 0,
-      pendingRequests: /* @__PURE__ */ new Map()
-    };
-    this.pageLogBuffers.set(page, buffers);
-    if (this.logCaptureConfig.console) {
-      page.on("console", (msg) => {
-        buffers.consoleLogs.push({
-          level: msg.type(),
-          text: msg.text(),
-          location: msg.location(),
-          timestamp: Date.now()
-        });
-        if (buffers.consoleLogs.length > 1e3) {
-          buffers.consoleLogs = buffers.consoleLogs.slice(-500);
-        }
-      });
-    }
-    if (this.logCaptureConfig.network) {
-      page.on("request", (request) => {
-        buffers.pendingRequests.set(request.url() + request.method(), {
-          url: request.url(),
-          method: request.method(),
-          headers: request.headers(),
-          startTime: Date.now(),
-          postData: request.postData() ?? void 0
-        });
-      });
-      page.on("response", async (response) => {
-        const key = response.url() + response.request().method();
-        const pending = buffers.pendingRequests.get(key);
-        buffers.pendingRequests.delete(key);
-        let body;
-        try {
-          const buf = await response.body();
-          const ct = response.headers()["content-type"] ?? "";
-          if (ct.includes("image/") && !ct.includes("svg")) {
-            body = buf.length > 32768 ? void 0 : `data:${ct.split(";")[0]};base64,${buf.toString("base64")}`;
-          } else {
-            const text = buf.toString("utf-8");
-            body = text.length > 32768 ? text.slice(0, 32768) + "...[truncated]" : text;
-          }
-        } catch {
-          body = void 0;
-        }
-        buffers.networkLogs.push({
-          url: response.url(),
-          method: response.request().method(),
-          status: response.status(),
-          requestHeaders: pending?.headers ?? response.request().headers(),
-          responseHeaders: response.headers(),
-          body,
-          requestBody: pending?.postData,
-          startTime: pending?.startTime ?? Date.now(),
-          endTime: Date.now(),
-          timing: response.request().timing()
-        });
-        if (buffers.networkLogs.length > 500) {
-          buffers.networkLogs = buffers.networkLogs.slice(-250);
-        }
-      });
-    }
-  }
-  async resolveTabTargetAsync(tab) {
-    const pages = this.context.pages();
-    if (tab.index !== void 0) {
-      return tab.index >= 0 && tab.index < pages.length ? pages[tab.index] : void 0;
-    }
-    if (tab.title) {
-      for (const p of pages) {
-        const t = await p.title();
-        if (t.includes(tab.title)) return p;
-      }
-      return void 0;
-    }
-    if (tab.url) {
-      return pages.find((p) => p.url().includes(tab.url));
-    }
-    return void 0;
-  }
-  async executeAction(action) {
-    const page = this.page;
-    const resolver = new ElementResolver(page, this.lastRefs);
-    for (const ref of laneRefs(action)) {
-      const entry = this.lastRefs[ref];
-      if (entry === void 0) continue;
-      const check = action.type === "scroll" ? await checkDocument(page, this.epoch) : await checkBinding(page, this.epoch, entry);
-      if (check.outcome !== "ok") return bindingRefusal(check.outcome, ref);
-    }
-    if ("ref" in action && typeof action.ref === "string") {
-      const refData = this.lastRefs[action.ref];
-      const role = refData?.role;
-      const validation = validateAction(action, role);
-      if (!validation.valid) {
-        return { success: false, error: validation.error };
-      }
-    }
-    switch (action.type) {
-      case "click": {
-        const locator = resolver.resolve(action.ref);
-        const box = await resolver.getBoundingBox(action.ref);
-        const coordinates = box ? { x: box.x + box.width / 2, y: box.y + box.height / 2 } : void 0;
-        await locator.click({
-          ...clickDelayOption2(action.clickDelay)
-        });
-        return { success: true, coordinates, boundingBox: box ?? void 0 };
-      }
-      case "fill": {
-        const locator = resolver.resolve(action.ref);
-        const box = await resolver.getBoundingBox(action.ref);
-        return runWebFillCompound(locator, box ?? void 0, action);
-      }
-      case "openApp": {
-        return webOpenAppError();
-      }
-      case "select": {
-        const locator = resolver.resolve(action.ref);
-        const box = await resolver.getBoundingBox(action.ref);
-        await locator.selectOption(action.value);
-        return { success: true, boundingBox: box ?? void 0 };
-      }
-      case "navigate": {
-        switch (action.to) {
-          case "url":
-            await page.goto(action.url, { waitUntil: "domcontentloaded" });
-            break;
-          case "back":
-            await page.goBack({ waitUntil: "domcontentloaded" });
-            break;
-          case "forward":
-            await page.goForward({ waitUntil: "domcontentloaded" });
-            break;
-          case "reload":
-            await page.reload({ waitUntil: "domcontentloaded" });
-            break;
-        }
-        await waitForPageReady(page);
-        return { success: true };
-      }
-      case "scroll": {
-        return runWebScrollCompound(page, this.lastRefs, action);
-      }
-      case "waitFor": {
-        const timeout = action.timeoutMs;
-        try {
-          switch (action.on) {
-            case "text":
-              await page.getByText(action.text).first().waitFor({ state: "visible", timeout });
-              break;
-            case "gone":
-              await page.getByText(action.text).first().waitFor({ state: "hidden", timeout });
-              break;
-            case "selector":
-              await page.waitForSelector(action.selector, { timeout });
-              break;
-          }
-        } catch {
-          const what = action.on === "selector" ? `selector "${action.selector}"` : `text "${action.text}"`;
-          const how = action.on === "gone" ? "was still present after" : "did not appear within";
-          return { success: false, error: `waitFor: ${what} ${how} ${timeout}ms.` };
-        }
-        return { success: true };
-      }
-      case "delay": {
-        await page.waitForTimeout(action.ms);
-        return { success: true };
-      }
-      case "waitForUrl": {
-        try {
-          await page.waitForURL(action.pattern, { timeout: 3e4 });
-          return { success: true };
-        } catch (err) {
-          return {
-            success: false,
-            error: `URL pattern "${action.pattern}" did not match within 30s. Hint: use "**" wildcards for substring matching (e.g., "**/dashboard**"). ${err instanceof Error ? err.message : String(err)}`
-          };
-        }
-      }
-      case "keypress": {
-        const effectiveKeys = convertKeysForPlatform2(action.keys, {
-          enabled: action.convertPlatformKeys !== false,
-          isMac: isMacPlatform2()
-        });
-        for (const key of effectiveKeys) {
-          if (action.mode === "down") {
-            await page.keyboard.down(key);
-          } else if (action.mode === "up") {
-            await page.keyboard.up(key);
-          } else {
-            await page.keyboard.press(key);
-          }
-        }
-        return { success: true };
-      }
-      case "hover": {
-        const locator = resolver.resolve(action.ref);
-        const box = await resolver.getBoundingBox(action.ref);
-        await locator.hover();
-        return { success: true, boundingBox: box ?? void 0 };
-      }
-      case "paste": {
-        const locator = resolver.resolve(action.ref);
-        const box = await resolver.getBoundingBox(action.ref);
-        await locator.focus();
-        await page.evaluate(`(() => {
-          const el = document.activeElement;
-          if (!el) return;
-          const dt = new DataTransfer();
-          dt.setData('text/plain', ${JSON.stringify(action.value)});
-          el.dispatchEvent(new ClipboardEvent('paste', {
-            clipboardData: dt,
-            bubbles: true,
-            cancelable: true,
-          }));
-        })()`);
-        return { success: true, boundingBox: box ?? void 0 };
-      }
-      case "fileUpload": {
-        const { existsSync } = await import("fs");
-        for (const filePath of action.files) {
-          if (!existsSync(filePath)) {
-            return { success: false, error: `File not found: ${filePath}` };
-          }
-        }
-        const locator = resolver.resolve(action.ref);
-        const box = await resolver.getBoundingBox(action.ref);
-        await locator.setInputFiles(action.files);
-        return { success: true, boundingBox: box ?? void 0 };
-      }
-      case "copy": {
-        const locator = resolver.resolve(action.ref);
-        const box = await resolver.getBoundingBox(action.ref);
-        const text = await locator.textContent() ?? "";
-        await page.evaluate(`navigator.clipboard.writeText(${JSON.stringify(text)})`);
-        return { success: true, boundingBox: box ?? void 0, data: { copied: text } };
-      }
-      case "tab": {
-        if (action.action === "new") {
-          const newPage = await this.context.newPage();
-          this.attachLogListeners(newPage);
-          await newPage.goto(action.url, { waitUntil: "domcontentloaded" });
-          await waitForPageReady(newPage);
-          this.page = newPage;
-          return { success: true };
-        }
-        const pages = this.context.pages();
-        let target;
-        if (action.index !== void 0) {
-          if (action.index < 0 || action.index >= pages.length) {
-            return { success: false, error: `Tab index ${action.index} out of range (${pages.length} tabs open)` };
-          }
-          target = pages[action.index];
-        } else if (action.title !== void 0) {
-          for (const p of pages) {
-            const t = await p.title();
-            if (t.includes(action.title)) {
-              target = p;
-              break;
-            }
-          }
-        } else if (action.url !== void 0) {
-          target = pages.find((p) => p.url().includes(action.url));
-        }
-        if (!target) {
-          return { success: false, error: `No tab found matching ${JSON.stringify({ index: action.index, title: action.title, url: action.url })}` };
-        }
-        this.page = target;
-        return { success: true };
-      }
-      case "inspect": {
-        switch (action.what) {
-          case "console": {
-            let entries;
-            if (action.tab) {
-              const targetPage = await this.resolveTabTargetAsync(action.tab);
-              if (!targetPage) {
-                return { success: false, error: `No tab found matching ${JSON.stringify(action.tab)}` };
-              }
-              const buffers = this.pageLogBuffers.get(targetPage);
-              entries = buffers ? [...buffers.consoleLogs] : [];
-            } else {
-              entries = [];
-              for (const buffers of this.pageLogBuffers.values()) {
-                entries.push(...buffers.consoleLogs);
-              }
-            }
-            if (action.level) {
-              entries = entries.filter((e) => e.level === action.level);
-            }
-            return { success: true, data: entries };
-          }
-          case "network": {
-            let entries;
-            if (action.tab) {
-              const targetPage = await this.resolveTabTargetAsync(action.tab);
-              if (!targetPage) {
-                return { success: false, error: `No tab found matching ${JSON.stringify(action.tab)}` };
-              }
-              const buffers = this.pageLogBuffers.get(targetPage);
-              entries = buffers ? [...buffers.networkLogs] : [];
-            } else {
-              entries = [];
-              for (const buffers of this.pageLogBuffers.values()) {
-                entries.push(...buffers.networkLogs);
-              }
-            }
-            if (action.urlPattern) {
-              entries = entries.filter((e) => e.url.includes(action.urlPattern));
-            }
-            return { success: true, data: entries };
-          }
-          case "cookies": {
-            const cookies = await this.context.cookies();
-            if (action.name) {
-              const cookie = cookies.find((c) => c.name === action.name) ?? null;
-              return { success: true, data: cookie };
-            }
-            return { success: true, data: cookies };
-          }
-          case "localStorage": {
-            const pageUrl = page.url();
-            if (pageUrl === "about:blank") {
-              return { success: true, data: action.key ? null : {} };
-            }
-            if (action.key) {
-              const value = await page.evaluate(
-                (k) => localStorage.getItem(k),
-                action.key
-              );
-              return { success: true, data: value };
-            }
-            const all = await page.evaluate(
-              () => Object.fromEntries(
-                Object.keys(localStorage).map((k) => [k, localStorage.getItem(k)])
-              )
-            );
-            return { success: true, data: all };
-          }
-        }
-        return { success: true };
-      }
-      case "setCookies": {
-        const cookiesWithDefaults = action.cookies.map((c) => ({
-          ...c,
-          url: !c.domain ? page.url() : void 0
-        }));
-        await this.context.addCookies(cookiesWithDefaults);
-        return { success: true };
-      }
-      case "setLocalStorage": {
-        await page.evaluate((entries) => {
-          for (const { key, value } of entries) {
-            localStorage.setItem(key, value);
-          }
-        }, action.entries);
-        return { success: true };
-      }
-      case "focus": {
-        const locator = resolver.resolve(action.ref);
-        const box = await resolver.getBoundingBox(action.ref);
-        await locator.focus();
-        return { success: true, boundingBox: box ?? void 0 };
-      }
-      case "assertValue": {
-        let value;
-        if ("expr" in action) {
-          value = await page.evaluate(action.expr);
-        } else {
-          switch (action.source) {
-            case "url":
-              value = page.url();
-              break;
-            case "storage":
-              value = page.url() === "about:blank" ? {} : await page.evaluate(
-                () => Object.fromEntries(
-                  Object.keys(localStorage).map((k) => [k, localStorage.getItem(k)])
-                )
-              );
-              break;
-            case "network":
-              value = this.peekNetworkLogs();
-              break;
-            case "expr-result":
-              value = void 0;
-              break;
-          }
-        }
-        return { success: true, data: value };
-      }
-      case "clearText": {
-        const loc = resolver.resolve(action.ref);
-        const clearBox = await resolver.getBoundingBox(action.ref);
-        await loc.clear();
-        return { success: true, boundingBox: clearBox ?? void 0 };
-      }
-      case "doubleClick": {
-        const locator = resolver.resolve(action.ref);
-        const box = await resolver.getBoundingBox(action.ref);
-        const coordinates = box ? action.relativePosition ? { x: box.x + action.relativePosition.x, y: box.y + action.relativePosition.y } : { x: box.x + box.width / 2, y: box.y + box.height / 2 } : void 0;
-        await locator.dblclick({
-          ...action.relativePosition && { position: action.relativePosition },
-          ...clickDelayOption2(action.clickDelay)
-        });
-        return { success: true, coordinates, boundingBox: box ?? void 0 };
-      }
-      case "rightClick": {
-        const locator = resolver.resolve(action.ref);
-        const box = await resolver.getBoundingBox(action.ref);
-        const coordinates = box ? action.relativePosition ? { x: box.x + action.relativePosition.x, y: box.y + action.relativePosition.y } : { x: box.x + box.width / 2, y: box.y + box.height / 2 } : void 0;
-        await locator.click({
-          button: "right",
-          ...action.relativePosition && { position: action.relativePosition },
-          ...clickDelayOption2(action.clickDelay)
-        });
-        return { success: true, coordinates, boundingBox: box ?? void 0 };
-      }
-      case "route": {
-        await this.context.route(action.urlPattern, async (route) => {
-          await route.fulfill({
-            status: 200,
-            ...action.contentType !== void 0 ? { contentType: action.contentType } : {},
-            ...action.headers !== void 0 ? { headers: action.headers } : {},
-            ...action.body !== void 0 ? { body: action.body } : {}
-          });
-        });
-        this.armedRoutes.add(action.urlPattern);
-        return { success: true };
-      }
-      case "unroute": {
-        if (action.urlPattern !== void 0) {
-          await this.context.unroute(action.urlPattern);
-          this.armedRoutes.delete(action.urlPattern);
-        } else {
-          await this.context.unrouteAll({ behavior: "ignoreErrors" });
-          this.armedRoutes.clear();
-        }
-        return { success: true };
-      }
-      case "networkState": {
-        if (action.mode === "offline") {
-          await this.context.setOffline(true);
-          return { success: true };
-        }
-        try {
-          const cdp = await this.context.newCDPSession(page);
-          await cdp.send("Network.emulateNetworkConditions", {
-            offline: false,
-            latency: action.latencyMs,
-            downloadThroughput: action.downloadKbps * 1e3 / 8,
-            uploadThroughput: action.uploadKbps * 1e3 / 8
-          });
-          return { success: true };
-        } catch (err) {
-          return {
-            success: false,
-            error: `Network throttling is only available on Chromium (via CDP); this context does not support it. ${err instanceof Error ? err.message : String(err)}`
-          };
-        }
-      }
-      case "storageState": {
-        if (action.op === "save") {
-          const state = await this.context.storageState();
-          return { success: true, data: { name: action.name, state } };
-        }
-        await this.context.setStorageState(readSeamStorageState2(action));
-        return { success: true };
-      }
-      case "handleDialog": {
-        if (this.pendingDialogArm) {
-          page.off("dialog", this.pendingDialogArm);
-          this.pendingDialogArm = null;
-        }
-        const accept = action.accept;
-        const promptText = action.promptText;
-        const handler = (dialog) => {
-          this.pendingDialogArm = null;
-          if (accept) {
-            void dialog.accept(promptText);
-          } else {
-            void dialog.dismiss();
-          }
-        };
-        this.pendingDialogArm = handler;
-        page.once("dialog", handler);
-        return { success: true };
-      }
-      case "executeScript": {
-        return { success: false, error: "executeScript not supported on farm adapter" };
-      }
-      // Runner-minted / author-channel verbs (D-01/D-15/D-16): reportValue, uniqueValue, assertAI,
-      // extractAI, and setVariable are intercepted at the dispatch seam and never reach the adapter.
-      // A grouped §7.1 defensive case surfaces a dispatch-routing error if one arrives here;
-      // assertNever remains the backstop for a genuinely unknown schema verb.
-      case "reportValue":
-      case "uniqueValue":
-      case "assertAI":
-      case "extractAI":
-      case "setVariable":
-        return {
-          success: false,
-          error: `Action "${action.type}" is handled by the runner dispatch seam and must not reach the web adapter (runner-minted/author-channel verb). This indicates a dispatch routing error.`
-        };
-      default:
-        return assertNever2(action);
-    }
-  }
-};
-
 // src/accessibility.ts
 import { AxeBuilder } from "@axe-core/playwright";
 async function runAccessibilityCheck(page, options) {
@@ -3962,10 +3008,7 @@ async function runAccessibilityCheck(page, options) {
 export {
   ActionValidationError,
   ElementResolver,
-  FarmWebAdapter,
   WebPlatformAdapter,
-  extractDom,
-  observePage,
   parseAriaSnapshot,
   runAccessibilityCheck,
   validateAction,