@delacour/warden-e2e 0.2.0 → 0.4.0

package/{chunk-7ns30pbp.mjs → chunk-3874jt2j.mjs}

@@ -64,10 +64,17 @@ var READS = new Set([
   "previous",
   "peek"
 ]);
+var WAITS = new Set(["settle"]);
 var READS_WITHOUT_ARGUMENT = new Set(["orientation", "appearance", "clipboard"]);
 function isCall(value) {
   return typeof value === "function";
 }
+function reportsQuiet(result) {
+  if (typeof result !== "object" || result === null || !("success" in result) || result.success !== true)
+    return false;
+  const data = "data" in result ? result.data : undefined;
+  return typeof data === "object" && data !== null && "quiet" in data && data.quiet === true;
+}
 function isThenable(value) {
   return typeof value === "object" && value !== null && "then" in value && typeof value.then === "function";
 }
@@ -137,21 +144,31 @@ function cacheObservations(driver, options = {}) {
       return { success: true, data: reader.alertIn(taken.data) };
     };
   };
-  const asInput = (fn, target) => {
+  const edged = (fn, target, edge) => {
     return (...args) => {
-      inputEdge();
+      edge();
       let result;
       try {
         result = Reflect.apply(fn, target, args);
       } catch (error) {
-        inputEdge();
+        edge();
         throw error;
       }
       if (!isThenable(result)) {
-        inputEdge();
+        edge();
         return result;
       }
-      return Promise.resolve(result).finally(inputEdge);
+      return Promise.resolve(result).finally(edge);
+    };
+  };
+  const asInput = (fn, target) => edged(fn, target, inputEdge);
+  const asWait = (fn, target) => {
+    const waited = edged(fn, target, moveOn);
+    return async (...args) => {
+      const result = await waited(...args);
+      if (reportsQuiet(result))
+        lastInputAt = undefined;
+      return result;
     };
   };
   const wrapMember = (name, value, target) => {
@@ -159,6 +176,8 @@ function cacheObservations(driver, options = {}) {
       return wrap(value, {});
     if (!isCall(value) || READS.has(name))
       return value;
+    if (WAITS.has(name))
+      return asWait(value, target);
     const input = asInput(value, target);
     if (!READS_WITHOUT_ARGUMENT.has(name))
       return input;
@@ -271,6 +290,9 @@ function canSelectAll(driver) {
 function canSetText(driver) {
   return typeof driver.setText === "function";
 }
+function canPasteText(driver) {
+  return typeof driver.pasteText === "function";
+}
 var segmenter = new Intl.Segmenter(undefined, { granularity: "grapheme" });
 function graphemesOf(text) {
   return Array.from(segmenter.segment(text), (part) => part.segment);
@@ -834,34 +856,34 @@ async function confirmFieldValue(request) {
   const { now, sleep } = request;
   const start = now();
   const cap = request.maxMs === undefined ? Number.POSITIVE_INFINITY : start + request.maxMs;
-  let deadline = Math.min(start + request.budgetMs, cap);
-  let held = "(gone)";
-  let streak = 0;
+  const reads = request.reads ?? CONFIRM_READS;
+  let poll = { deadline: Math.min(start + request.budgetMs, cap), held: "(gone)", streak: 0 };
   for (;; ) {
     const read = await request.read();
     if (!read.ok)
       return { status: "failed", error: read.error };
-    const { reading } = read;
-    if (reading.kind === "unreadable") {
-      streak = 0;
-      held = reading.note;
-    } else if (reading.value === request.text) {
-      streak += 1;
-      if (streak >= (request.reads ?? CONFIRM_READS))
-        return { status: "confirmed" };
-      held = reading.value;
-      deadline = Math.max(deadline, Math.min(now() + 2 * FIELD_POLL_MS, cap));
-    } else {
-      streak = 0;
-      if (reading.value !== held)
-        deadline = Math.max(deadline, Math.min(now() + FIELD_PROGRESS_MS, cap));
-      held = reading.value;
-    }
-    if (now() >= deadline)
-      return { status: "mismatch", held };
+    poll = foldReading(poll, read.reading, { text: request.text, now: now(), cap, reads });
+    if (poll.streak > 0 && poll.streak >= reads)
+      return { status: "confirmed" };
+    if (now() >= poll.deadline)
+      return { status: "mismatch", held: poll.held };
     await sleep(FIELD_POLL_MS);
   }
 }
+function foldReading(poll, reading, at) {
+  if (reading.kind === "unreadable")
+    return { ...poll, streak: 0, held: reading.note };
+  if (reading.value === at.text) {
+    const streak = poll.streak + 1;
+    if (streak >= at.reads)
+      return { ...poll, streak };
+    const deadline = Math.max(poll.deadline, Math.min(at.now + 2 * FIELD_POLL_MS, at.cap));
+    return { deadline, held: reading.value, streak };
+  }
+  const progressed = reading.value !== poll.held;
+  const deadline = progressed ? Math.max(poll.deadline, Math.min(at.now + FIELD_PROGRESS_MS, at.cap)) : poll.deadline;
+  return { deadline, held: reading.value, streak: 0 };
+}
 async function hitTestField(driver, wanted) {
   const { x, y, width, height } = wanted.element.frame;
   const hit = await driver.elementAtPoint({ x: x + width / 2, y: y + height / 2 });
@@ -921,7 +943,7 @@ async function focusAndClear(driver, sleep, point, entry, method = "auto") {
     return prepared;
   return prepared.data.pending === "selection" ? pressKeys(driver, sleep, "Backspace", 1) : ok(undefined);
 }
-async function focusClearType(driver, sleep, point, entry, text, method = "auto", env = process.env) {
+async function focusClearType(driver, sleep, point, entry, text, method = "auto", env = process.env, via = "paste") {
   const wantsSetText = method === "setText" || method === "auto" && setTextOptedIn(env);
   if (wantsSetText && entry !== undefined && fieldContent(entry).kind === "text" && canSetText(driver)) {
     const focused = await driver.tap(point);
@@ -930,15 +952,20 @@ async function focusClearType(driver, sleep, point, entry, text, method = "auto"
     const replaced = await driver.setText(text);
     if (replaced.success)
       return replaced;
-    return typeOver(driver, sleep, await prepareFocused(driver, sleep, entry, method), text);
+    return typeOver(driver, sleep, await prepareFocused(driver, sleep, entry, method), text, "type");
   }
-  return typeOver(driver, sleep, await focusAndSelect(driver, sleep, point, entry, method), text);
+  return typeOver(driver, sleep, await focusAndSelect(driver, sleep, point, entry, method), text, via);
 }
-async function typeOver(driver, sleep, prepared, text) {
+async function typeOver(driver, sleep, prepared, text, via) {
   if (!prepared.success)
     return prepared;
   if (text === "")
     return prepared.data.pending === "selection" ? pressKeys(driver, sleep, "Backspace", 1) : ok(undefined);
+  if (via === "paste" && canPasteText(driver)) {
+    const pasted = await driver.pasteText(text);
+    if (pasted.success)
+      return pasted;
+  }
   return typeText(driver, sleep, text);
 }
 
@@ -1750,10 +1777,20 @@ class Locator {
     const reason = blockedReason(entry, spec, observed);
     if (reason !== undefined)
       return { done: false, state: { kind: "blocked", reason, snapshot: observed.snapshot } };
-    if (!anyFrame && !this.heldStill(entry, observation.earlier))
-      return "moving";
+    if (!anyFrame && !this.heldStill(entry, observation.earlier)) {
+      const compared = observation.earlier?.previous !== undefined;
+      if (compared || !await this.stillByHitTest(entry, observed))
+        return "moving";
+    }
     return { done: true, value: { entry, observed } };
   }
+  async stillByHitTest(entry, observed) {
+    const { driver } = observed;
+    if (driver.capabilities.cheapHitTest !== true || this.rt.host.answerSystemAlert !== undefined)
+      return false;
+    const hit = await driver.elementAtPoint(tapPointOf(entry));
+    return hit.success && hit.data !== null && sameElement(hit.data, entry.element);
+  }
   heldStill(entry, earlier) {
     if (earlier === undefined)
       return true;
@@ -1851,14 +1888,15 @@ class Locator {
     });
   }
   async fill(text, options = {}) {
-    assertOptions("fill", options, ["timeout"]);
+    assertOptions("fill", options, ["via", "timeout"]);
+    const via = fillViaOf(this, options.via);
     return this.act("fill", async () => {
       const budget = this.rt.budget(options.timeout);
       let target = await this.actionable({ enabled: true, tapPointOnScreen: false }, budget.remaining());
       let firstHeld;
       for (let attempt = 1;; attempt += 1) {
         const point = focusPoint(target.entry.element.frame);
-        this.rt.drive("fill", await focusClearType(target.observed.driver, this.pause, point, target.entry, text, clearMethodFor(attempt)));
+        this.rt.drive("fill", await focusClearType(target.observed.driver, this.pause, point, target.entry, text, clearMethodFor(attempt), process.env, viaFor(attempt, via)));
         if (target.entry.secure)
           return;
         const outcome = await this.confirm(target, text, budget);
@@ -2067,6 +2105,14 @@ function retryPlan(options) {
 function describeUntil(until) {
   return typeof until === "function" ? "check" : String(until);
 }
+function fillViaOf(locator, via) {
+  if (via === undefined || via === "paste" || via === "type")
+    return via ?? "paste";
+  throw new E2eError2("INVALID_ARGUMENT", `${locator}: fill via must be "paste" or "type", got ${JSON.stringify(via)}`);
+}
+function viaFor(attempt, via) {
+  return attempt === 1 ? via : "type";
+}
 function clearMethodFor(attempt) {
   return attempt === 1 ? "auto" : "counted";
 }
@@ -2201,6 +2247,32 @@ function textOf2(data) {
     return new TextDecoder().decode(new Uint8Array(data.buffer, data.byteOffset, data.byteLength));
   return;
 }
+function taggedBindingPayload(params) {
+  const call = bindingCalledSchema.safeParse(params);
+  if (!call.success)
+    return;
+  let payload;
+  try {
+    payload = JSON.parse(call.data.payload);
+  } catch {
+    payload = undefined;
+  }
+  const tagged = bindingPayloadSchema.safeParse(payload);
+  return tagged.success ? { requestId: tagged.data.requestId, payload } : undefined;
+}
+function parseEnvelope(data) {
+  const text = textOf2(data);
+  if (text === undefined)
+    return;
+  let json;
+  try {
+    json = JSON.parse(text);
+  } catch {
+    return;
+  }
+  const message = envelopeSchema.safeParse(json);
+  return message.success ? message.data : undefined;
+}
 function inspectorOrigin(wsUrl) {
   if (!URL.canParse(wsUrl))
     return;
@@ -2261,18 +2333,9 @@ async function openCdp(wsUrl, options = {}) {
   };
   const dispatch = (method, params) => {
     if (method === "Runtime.bindingCalled") {
-      const call = bindingCalledSchema.safeParse(params);
-      if (call.success) {
-        let payload;
-        try {
-          payload = JSON.parse(call.data.payload);
-        } catch {
-          payload = undefined;
-        }
-        const tagged = bindingPayloadSchema.safeParse(payload);
-        if (tagged.success)
-          bindings.get(tagged.data.requestId)?.settle(ok(payload));
-      }
+      const tagged = taggedBindingPayload(params);
+      if (tagged)
+        bindings.get(tagged.requestId)?.settle(ok(tagged.payload));
     }
     for (const handler of [...anyHandlers])
       handler(method, params);
@@ -2280,19 +2343,10 @@ async function openCdp(wsUrl, options = {}) {
       handler(params);
   };
   ws.addEventListener("message", (event) => {
-    const text = textOf2(event.data);
-    if (text === undefined)
-      return;
-    let json;
-    try {
-      json = JSON.parse(text);
-    } catch {
-      return;
-    }
-    const message = envelopeSchema.safeParse(json);
-    if (!message.success)
+    const message = parseEnvelope(event.data);
+    if (!message)
       return;
-    const { id, error, result, method, params } = message.data;
+    const { id, error, result, method, params } = message;
     if (id !== undefined) {
       const request = pending.get(id);
       if (!request)
@@ -2305,7 +2359,7 @@ async function openCdp(wsUrl, options = {}) {
     if (method)
       dispatch(method, params);
   });
-  ws.addEventListener("close", () => {
+  ws.addEventListener("close", (event) => {
     if (closed)
       return;
     closed = true;
@@ -2318,7 +2372,7 @@ async function openCdp(wsUrl, options = {}) {
       binding.settle(devtoolsErr("cdp_closed", "CDP connection closed"));
     if (!intentional)
       for (const handler of [...closeHandlers])
-        handler();
+        handler({ code: event.code, reason: event.reason });
   });
   const subscribe = (set, handler) => {
     set.add(handler);
@@ -2419,7 +2473,8 @@ var stackTraceSchema = z2.looseObject({
   callFrames: z2.array(z2.looseObject({
     url: z2.string().optional(),
     lineNumber: z2.number().optional(),
-    columnNumber: z2.number().optional()
+    columnNumber: z2.number().optional(),
+    functionName: z2.string().optional()
   }))
 });
 var consoleCalledSchema = z2.looseObject({
@@ -2430,7 +2485,7 @@ var consoleCalledSchema = z2.looseObject({
 });
 var exceptionThrownSchema = z2.looseObject({
   timestamp: z2.number().optional(),
-  exceptionDetails: exceptionDetailsSchema
+  exceptionDetails: exceptionDetailsSchema.extend({ stackTrace: stackTraceSchema.optional() })
 });
 var LEVELS = {
   log: "log",
@@ -2455,6 +2510,20 @@ function formatPreview(object) {
   const name = object.className && object.className !== "Object" ? `${object.className} ` : "";
   return `${name}{${body}${more}}`;
 }
+function formatObject(object) {
+  if (object.subtype === "null")
+    return "null";
+  if (object.value !== undefined)
+    return JSON.stringify(object.value);
+  if (object.subtype === "error")
+    return object.description ?? "Error";
+  return formatPreview(object) ?? object.description ?? object.className ?? "Object";
+}
+function formatFunction(object) {
+  const first = (object.description ?? "function").split(`
+`)[0] ?? "function";
+  return first.length > MAX_FUNCTION_TEXT ? `${first.slice(0, MAX_FUNCTION_TEXT)}\u2026` : first;
+}
 function formatValue2(object) {
   switch (object.type) {
     case "string":
@@ -2465,24 +2534,18 @@ function formatValue2(object) {
     case "boolean":
     case "bigint":
       return object.unserializableValue ?? object.description ?? String(object.value);
-    case "function": {
-      const first = (object.description ?? "function").split(`
-`)[0] ?? "function";
-      return first.length > MAX_FUNCTION_TEXT ? `${first.slice(0, MAX_FUNCTION_TEXT)}\u2026` : first;
-    }
-    case "object": {
-      if (object.subtype === "null")
-        return "null";
-      if (object.value !== undefined)
-        return JSON.stringify(object.value);
-      if (object.subtype === "error")
-        return object.description ?? "Error";
-      return formatPreview(object) ?? object.description ?? object.className ?? "Object";
-    }
+    case "function":
+      return formatFunction(object);
+    case "object":
+      return formatObject(object);
     default:
       return object.description ?? `[${object.type}]`;
   }
 }
+function formatNumeric(spec, arg) {
+  const n = Number(arg.value ?? arg.description);
+  return Number.isNaN(n) ? "NaN" : String(spec === "f" ? n : Math.trunc(n));
+}
 function applyFormat(format, rest) {
   let used = 0;
   const text = format.replace(/%([sdifoOjc%])/g, (whole, spec) => {
@@ -2494,10 +2557,8 @@ function applyFormat(format, rest) {
     used++;
     if (spec === "c")
       return "";
-    if (spec === "d" || spec === "i" || spec === "f") {
-      const n = Number(arg.value ?? arg.description);
-      return Number.isNaN(n) ? "NaN" : String(spec === "f" ? n : Math.trunc(n));
-    }
+    if (spec === "d" || spec === "i" || spec === "f")
+      return formatNumeric(spec, arg);
     return formatValue2(arg);
   });
   return { text, used };
@@ -2515,6 +2576,20 @@ function sourceOf(url, line, col) {
     return;
   return { url, line: (line ?? 0) + 1, col: (col ?? 0) + 1 };
 }
+function framesOf(trace) {
+  const frames = [];
+  for (const frame of trace?.callFrames ?? []) {
+    if (!frame.url)
+      continue;
+    frames.push({
+      file: frame.url,
+      line: (frame.lineNumber ?? 0) + 1,
+      col: (frame.columnNumber ?? 0) + 1,
+      ...frame.functionName ? { fn: frame.functionName } : {}
+    });
+  }
+  return frames.length > 0 ? frames : undefined;
+}
 var lineKey = (ts, text) => `${ts}\x00${text}`;
 function createConsoleCapture(options = {}) {
   const ring = options.ring ?? DEFAULT_RING;
@@ -2562,13 +2637,15 @@ function createConsoleCapture(options = {}) {
     const formatted = formatConsoleArgs(args);
     const frame = stackTrace?.callFrames[0];
     const source = sourceOf(frame?.url, frame?.lineNumber, frame?.columnNumber);
+    const stack = framesOf(stackTrace);
     return {
       ts: timestamp ?? now(),
       level: LEVELS[type] ?? "log",
       kind: "console",
       text: formatted.text,
       args: formatted.args,
-      ...source ? { source } : {}
+      ...source ? { source } : {},
+      ...stack ? { stack } : {}
     };
   };
   const fromException = (params) => {
@@ -2577,12 +2654,14 @@ function createConsoleCapture(options = {}) {
       return;
     const { exceptionDetails: details, timestamp } = parsed.data;
     const source = sourceOf(details.url, details.lineNumber, details.columnNumber);
+    const stack = framesOf(details.stackTrace);
     return {
       ts: timestamp ?? now(),
       level: "error",
       kind: "exception",
       text: describeException(details),
-      ...source ? { source } : {}
+      ...source ? { source } : {},
+      ...stack ? { stack } : {}
     };
   };
   return {
@@ -3019,7 +3098,8 @@ async function connectDevtools(o) {
   const cdpHandlers = new Map;
   const eventHandlers = {
     reconnected: new Set,
-    lost: new Set
+    lost: new Set,
+    yielded: new Set
   };
   let unsubscribeCdp = [];
   let connection = 0;
@@ -3069,60 +3149,78 @@ async function connectDevtools(o) {
       for (const handler of handlers)
         unsubscribeCdp.push(attached.cdp.on(method, handler));
     }
-    attached.cdp.onClose(() => {
-      if (state.kind === "up" && state.attached.cdp === attached.cdp)
-        reconnect("socket closed");
+    attached.cdp.onClose((info) => {
+      if (state.kind !== "up" || state.attached.cdp !== attached.cdp)
+        return;
+      if (o.yieldOnClose?.(info)) {
+        state = { kind: "closed" };
+        log(`devtools: yielded (${info.code} ${info.reason})`);
+        for (const handler of [...eventHandlers.yielded])
+          handler(info);
+        return;
+      }
+      reconnect("socket closed");
     });
     attached.cdp.on("Runtime.executionContextsCleared", () => {
       if (state.kind === "up" && state.attached.cdp === attached.cdp)
         reconnect("JS context cleared");
     });
   }
+  const closedError = () => devtoolsErr("cdp_closed", "devtools session is closed");
+  function adopt(attached) {
+    attach(attached);
+    log(`devtools: reconnected to ${attached.target.id}`);
+    for (const handler of [...eventHandlers.reconnected])
+      handler(attached.target);
+  }
+  function adoptIfOpen(attached) {
+    if (phase() === "closed") {
+      attached.cdp.close();
+      return closedError();
+    }
+    adopt(attached);
+    return ok(attached);
+  }
+  function markLost(error) {
+    if (phase() === "closed")
+      return;
+    state = { kind: "lost", error };
+    for (const handler of [...eventHandlers.lost])
+      handler(error);
+  }
+  async function reconnectLoop(previous) {
+    previous.cdp.close();
+    let last = { code: "devtools_unavailable", message: "reconnect failed" };
+    const startedAt = now();
+    let slept = 0;
+    const leftMs = () => budgetMs - Math.max(now() - startedAt, slept);
+    for (let attempt = 1;attempt <= maxAttempts; attempt++) {
+      if (phase() === "closed")
+        return closedError();
+      const result = await establish();
+      if (result.success)
+        return adoptIfOpen(result.data);
+      last = result.error;
+      const left = leftMs();
+      const cap = Number.isFinite(maxAttempts) ? `/${maxAttempts}` : "";
+      log(`devtools: reconnect attempt ${attempt}${cap} failed: ${last.message}`);
+      if (attempt >= maxAttempts || left <= 0)
+        break;
+      const pause = Math.min(backoffAfter(attempt), left);
+      slept += pause;
+      await sleep(pause);
+    }
+    markLost(last);
+    return { success: false, error: last };
+  }
   function reconnect(reason) {
     if (state.kind === "reconnecting")
       return state.done;
     if (state.kind !== "up")
-      return Promise.resolve(devtoolsErr("cdp_closed", "devtools session is closed"));
+      return Promise.resolve(closedError());
     const previous = state.attached;
     log(`devtools: ${reason}, reconnecting`);
-    const done = (async () => {
-      previous.cdp.close();
-      let last = { code: "devtools_unavailable", message: "reconnect failed" };
-      const startedAt = now();
-      let slept = 0;
-      const leftMs = () => budgetMs - Math.max(now() - startedAt, slept);
-      for (let attempt = 1;attempt <= maxAttempts; attempt++) {
-        if (phase() === "closed")
-          return devtoolsErr("cdp_closed", "devtools session is closed");
-        const result = await establish();
-        if (result.success) {
-          if (phase() === "closed") {
-            result.data.cdp.close();
-            return devtoolsErr("cdp_closed", "devtools session is closed");
-          }
-          attach(result.data);
-          log(`devtools: reconnected to ${result.data.target.id}`);
-          for (const handler of [...eventHandlers.reconnected])
-            handler(result.data.target);
-          return result;
-        }
-        last = result.error;
-        const left = leftMs();
-        const cap = Number.isFinite(maxAttempts) ? `/${maxAttempts}` : "";
-        log(`devtools: reconnect attempt ${attempt}${cap} failed: ${last.message}`);
-        if (attempt >= maxAttempts || left <= 0)
-          break;
-        const pause = Math.min(backoffAfter(attempt), left);
-        slept += pause;
-        await sleep(pause);
-      }
-      if (phase() !== "closed") {
-        state = { kind: "lost", error: last };
-        for (const handler of [...eventHandlers.lost])
-          handler(last);
-      }
-      return { success: false, error: last };
-    })();
+    const done = reconnectLoop(previous);
     state = { kind: "reconnecting", done };
     epoch++;
     for (const wake of [...epochWaiters])
@@ -3136,16 +3234,13 @@ async function connectDevtools(o) {
       if (phase() === "closed") {
         if (result.success)
           result.data.cdp.close();
-        return devtoolsErr("cdp_closed", "devtools session is closed");
+        return closedError();
       }
       if (!result.success) {
         state = { kind: "lost", error: result.error };
         return result;
       }
-      attach(result.data);
-      log(`devtools: reconnected to ${result.data.target.id}`);
-      for (const handler of [...eventHandlers.reconnected])
-        handler(result.data.target);
+      adopt(result.data);
       return result;
     })();
     state = { kind: "reconnecting", done };
@@ -3160,6 +3255,44 @@ async function connectDevtools(o) {
       return revive();
     return devtoolsErr("cdp_closed", "devtools session is closed");
   }
+  async function requestReload(method, baseUrl) {
+    if (method !== "http") {
+      log(`devtools: reload via ${method}`);
+      return;
+    }
+    log("devtools: reload via http");
+    try {
+      const res = await o.fetch(`${baseUrl.replace(/\/+$/, "")}/reload`, { method: "POST" });
+      if (!res.ok) {
+        return devtoolsErr("devtools_unavailable", `reload failed: POST /reload answered ${res.status}`);
+      }
+    } catch (error) {
+      return devtoolsErr("devtools_unavailable", `reload failed: POST /reload threw ${String(error)}`);
+    }
+    return;
+  }
+  async function awaitReload(method, startedAt, waitMs) {
+    if (epoch === startedAt)
+      await waitForEpochChange(waitMs);
+    if (epoch === startedAt && state.kind === "up") {
+      log(`devtools: reload via ${method} not observed after ${waitMs} ms`);
+      return devtoolsErr("reload_failed", `reload via ${method} acknowledged but the JS context did not restart within ${waitMs} ms`);
+    }
+    if (state.kind !== "reconnecting")
+      return;
+    const back = await state.done;
+    return back.success ? undefined : back;
+  }
+  function waitForEpochChange(waitMs) {
+    return new Promise((resolve) => {
+      const wake = () => {
+        epochWaiters.delete(wake);
+        resolve();
+      };
+      epochWaiters.add(wake);
+      sleep(waitMs).then(wake);
+    });
+  }
   const first = await establish();
   if (!first.success)
     return first;
@@ -3197,39 +3330,8 @@ async function connectDevtools(o) {
         return devtoolsErr(probe.error.code, `reload probe failed: ${probe.error.message}`);
       }
       const method = readReloadMethod(probe.data) ?? "http";
-      if (method === "http") {
-        log("devtools: reload via http");
-        try {
-          const res = await o.fetch(`${metroUrl.replace(/\/+$/, "")}/reload`, { method: "POST" });
-          if (!res.ok) {
-            return devtoolsErr("devtools_unavailable", `reload failed: POST /reload answered ${res.status}`);
-          }
-        } catch (error) {
-          return devtoolsErr("devtools_unavailable", `reload failed: POST /reload threw ${String(error)}`);
-        }
-      } else {
-        log(`devtools: reload via ${method}`);
-      }
-      if (epoch === startedAt) {
-        await new Promise((resolve) => {
-          const wake = () => {
-            epochWaiters.delete(wake);
-            resolve();
-          };
-          epochWaiters.add(wake);
-          sleep(waitMs).then(wake);
-        });
-      }
-      if (epoch === startedAt && state.kind === "up") {
-        log(`devtools: reload via ${method} not observed after ${waitMs} ms`);
-        return devtoolsErr("reload_failed", `reload via ${method} acknowledged but the JS context did not restart within ${waitMs} ms`);
-      }
-      if (state.kind === "reconnecting") {
-        const back = await state.done;
-        if (!back.success)
-          return back;
-      }
-      return ok({ method });
+      const failure = await requestReload(method, metroUrl) ?? await awaitReload(method, startedAt, waitMs);
+      return failure ?? ok({ method });
     },
     get target() {
       if (state.kind === "up")
@@ -3909,6 +4011,25 @@ function spawnFailure(cmd, cwd, error) {
     return `cannot run \`${cmd.join(" ")}\`: no such directory ${cwd}`;
   return `cannot run \`${cmd.join(" ")}\`: ${error instanceof Error ? error.message : String(error)}`;
 }
+async function readLines(stream, onLine) {
+  const decoder = new TextDecoder;
+  let text = "";
+  let pending = "";
+  for await (const chunk of stream) {
+    const piece = decoder.decode(chunk, { stream: true });
+    text += piece;
+    const lines = (pending + piece).split(/\r?\n/);
+    pending = lines.pop() ?? "";
+    for (const line of lines)
+      onLine(line);
+  }
+  const rest = decoder.decode();
+  text += rest;
+  pending += rest;
+  if (pending !== "")
+    onLine(pending);
+  return text;
+}
 var bunExec = async (cmd, opts = {}) => {
   try {
     const proc = Bun.spawn([...cmd], {
@@ -3920,11 +4041,9 @@ var bunExec = async (cmd, opts = {}) => {
       timeout: opts.timeoutMs,
       ...opts.signal !== undefined ? { signal: opts.signal } : {}
     });
-    const [stdout, stderr, exitCode] = await Promise.all([
-      new Response(proc.stdout).text(),
-      new Response(proc.stderr).text(),
-      proc.exited
-    ]);
+    const { onLine } = opts;
+    const read = (stream) => onLine ? readLines(stream, onLine) : new Response(stream).text();
+    const [stdout, stderr, exitCode] = await Promise.all([read(proc.stdout), read(proc.stderr), proc.exited]);
     return { exitCode, stdout, stderr };
   } catch (error) {
     return { exitCode: 127, stdout: "", stderr: spawnFailure(cmd, opts.cwd, error) };
@@ -4158,6 +4277,8 @@ var frontmostDataSchema = z6.looseObject({
   pid: z6.number().optional(),
   frontmostPid: z6.number().optional()
 });
+var launchDataSchema = z6.looseObject({ pid: z6.number() });
+var terminateDataSchema = z6.looseObject({ terminated: z6.boolean() });
 var orientationDataSchema = z6.object({
   orientation: z6.enum([
     "portrait",
@@ -4179,7 +4300,9 @@ var opSchemas = {
   rebind: rebindDataSchema,
   alertButtons: alertButtonsDataSchema,
   frontmost: frontmostDataSchema,
-  orientation: orientationDataSchema
+  orientation: orientationDataSchema,
+  launch: launchDataSchema,
+  terminate: terminateDataSchema
 };
 function hasOpSchema(op) {
   return Object.hasOwn(opSchemas, op);
@@ -5456,7 +5579,7 @@ function parseBudgets(raw) {
 
 // ../../packages/e2e/src/perf/device-perf.ts
 var PERF_DIR = "perf";
-function parseEnvelope(stdout) {
+function parseEnvelope2(stdout) {
   try {
     const json = JSON.parse(stdout.trim().split(`
 `).at(-1) ?? "");
@@ -5509,7 +5632,7 @@ function createDevicePerf(deps) {
     if (deps.unavailable !== undefined)
       throw new E2eError2("SESSION", `device.perf unavailable: ${deps.unavailable}`);
     const { code, stdout, stderr } = await deps.exec(["perf", sub, "--json", "--udid", deps.udid, ...extra]);
-    const env = parseEnvelope(stdout);
+    const env = parseEnvelope2(stdout);
     if (env === undefined || !env.ok) {
       const why = env === undefined ? stderr.trim() || `exit ${code}` : `${env.error.code}: ${env.error.message}`;
       throw new E2eError2("SESSION", `warden perf ${sub} failed: ${why}`);
@@ -5827,6 +5950,6 @@ function onlyWasSeen() {
 
 // ../../packages/e2e/src/version.ts
 var WORKSPACE_VERSION = "0.0.0-workspace";
-var WARDEN_E2E_VERSION2 = "0.2.0";
+var WARDEN_E2E_VERSION2 = "0.4.0";
 
 export { E2eError2, noteSpanDetail, addSpanDetail, canObserve, canDetectAlerts, settleDetailOf, DEFAULT_SETTLE_QUIET_MS, DEFAULT_SETTLE_TIMEOUT_MS, settleByHash, snapshotHash, ok, err, swipeVector, screenRect, fieldValue, PINCH_MS, ROTATE_MS, PATH_MS, centreOf, pinchRadius, rotateRadius, requireGesture, assertScale, assertDegrees, isInteractiveRole, resolveRole, normalizeText, matchesText, indexSnapshot, testIdQuery, textQuery, roleQuery, selectorExpression, renderSnapshot, renderHeader, resolve, locateByTestIdViaReact, isLocator, Locator, pickOne, textOf, scrollUntilVisible, bunExec, execError, driverError, driverErr, logEventSchema, fatalEventSchema, responseSchema, mapWireError, encodeRequest, bunSpawn, stdioTransport, spawnSimd, connectSimd, isHidLost, ENV_NAMES, DEFAULT_ASSERTION_TIMEOUT_MS, readEnv, runStep, setDefaultHidRecovery, setDefaultNativeLog, setDefaultDriverFactory, hasDefaultDriverFactory, setDefaultFixtureFactory, hasDefaultFixtureFactory, attemptSession, getSession, parseBudgets, createDevicePerf, perfStartFor, spawnWarden, hash6, attemptDir, screenshotPath, specIdOf, realNativeLogDeps, captureNativeLog, callerFile, BUN_TIMEOUT_MARGIN_MS2, ownHook, currentScope, createScope, runInScope, hooksFor, resolveUse, registrationDefaults, markOnly, onlyWasSeen, WORKSPACE_VERSION, WARDEN_E2E_VERSION2 };