@yoqa/runner 1.0.0 → 1.0.3

package/dist/index.js

@@ -10112,7 +10112,7 @@ var require_bignumber = __commonJS((exports, module) => {
           return arr.reverse();
         }
         return function(str, baseIn, baseOut, sign, callerIsToString) {
-          var alphabet, d, e, k, r, x, xc, y, i = str.indexOf("."), dp = DECIMAL_PLACES, rm5 = ROUNDING_MODE;
+          var alphabet, d, e, k, r, x, xc, y, i = str.indexOf("."), dp = DECIMAL_PLACES, rm6 = ROUNDING_MODE;
           if (i >= 0) {
             k = POW_PRECISION;
             POW_PRECISION = 0;
@@ -10135,7 +10135,7 @@ var require_bignumber = __commonJS((exports, module) => {
             x.c = xc;
             x.e = e;
             x.s = sign;
-            x = div(x, y, dp, rm5, baseOut);
+            x = div(x, y, dp, rm6, baseOut);
             xc = x.c;
             r = x.r;
             e = x.e;
@@ -10144,7 +10144,7 @@ var require_bignumber = __commonJS((exports, module) => {
           i = xc[d];
           k = baseOut / 2;
           r = r || d < 0 || xc[d + 1] != null;
-          r = rm5 < 4 ? (i != null || r) && (rm5 == 0 || rm5 == (x.s < 0 ? 3 : 2)) : i > k || i == k && (rm5 == 4 || r || rm5 == 6 && xc[d - 1] & 1 || rm5 == (x.s < 0 ? 8 : 7));
+          r = rm6 < 4 ? (i != null || r) && (rm6 == 0 || rm6 == (x.s < 0 ? 3 : 2)) : i > k || i == k && (rm6 == 4 || r || rm6 == 6 && xc[d - 1] & 1 || rm6 == (x.s < 0 ? 8 : 7));
           if (d < 1 || !xc[0]) {
             str = r ? toFixedPoint(alphabet.charAt(1), -dp, alphabet.charAt(0)) : alphabet.charAt(0);
           } else {
@@ -10206,7 +10206,7 @@ var require_bignumber = __commonJS((exports, module) => {
           for (;!a[0] && a.length > 1; a.splice(0, 1))
             ;
         }
-        return function(x, y, dp, rm5, base) {
+        return function(x, y, dp, rm6, base) {
           var cmp, e, i, more, n, prod, prodL, q, qc, rem, remL, rem0, xi, xL, yc0, yL, yz, s = x.s == y.s ? 1 : -1, xc = x.c, yc = y.c;
           if (!xc || !xc[0] || !yc || !yc[0]) {
             return new BigNumber2(!x.s || !y.s || (xc ? yc && xc[0] == yc[0] : !yc) ? NaN : xc && xc[0] == 0 || !yc ? s * 0 : s / 0);
@@ -10306,7 +10306,7 @@ var require_bignumber = __commonJS((exports, module) => {
           if (base == BASE) {
             for (i = 1, s = qc[0];s >= 10; s /= 10, i++)
               ;
-            round(q, dp + (q.e = i + e * LOG_BASE - 1) + 1, rm5, more);
+            round(q, dp + (q.e = i + e * LOG_BASE - 1) + 1, rm6, more);
           } else {
             q.e = e;
             q.r = +more;
@@ -10314,12 +10314,12 @@ var require_bignumber = __commonJS((exports, module) => {
           return q;
         };
       }();
-      function format(n, i, rm5, id) {
+      function format(n, i, rm6, id) {
         var c0, e, ne2, len, str;
-        if (rm5 == null)
-          rm5 = ROUNDING_MODE;
+        if (rm6 == null)
+          rm6 = ROUNDING_MODE;
         else
-          intCheck(rm5, 0, 8);
+          intCheck(rm6, 0, 8);
         if (!n.c)
           return n.toString();
         c0 = n.c[0];
@@ -10328,7 +10328,7 @@ var require_bignumber = __commonJS((exports, module) => {
           str = coeffToString(n.c);
           str = id == 1 || id == 2 && (ne2 <= TO_EXP_NEG || ne2 >= TO_EXP_POS) ? toExponential(str, ne2) : toFixedPoint(str, ne2, "0");
         } else {
-          n = round(new BigNumber2(n), i, rm5);
+          n = round(new BigNumber2(n), i, rm6);
           e = n.e;
           str = coeffToString(n.c);
           len = str.length;
@@ -10409,7 +10409,7 @@ var require_bignumber = __commonJS((exports, module) => {
           x.c = x.e = null;
         };
       }();
-      function round(x, sd, rm5, r) {
+      function round(x, sd, rm6, r) {
         var d, i, j, k, n, ni, rd, xc = x.c, pows10 = POWS_TEN;
         if (xc) {
           out: {
@@ -10444,7 +10444,7 @@ var require_bignumber = __commonJS((exports, module) => {
               }
             }
             r = r || sd < 0 || xc[ni + 1] != null || (j < 0 ? n : n % pows10[d - j - 1]);
-            r = rm5 < 4 ? (rd || r) && (rm5 == 0 || rm5 == (x.s < 0 ? 3 : 2)) : rd > 5 || rd == 5 && (rm5 == 4 || r || rm5 == 6 && (i > 0 ? j > 0 ? n / pows10[d - j] : 0 : xc[ni - 1]) % 10 & 1 || rm5 == (x.s < 0 ? 8 : 7));
+            r = rm6 < 4 ? (rd || r) && (rm6 == 0 || rm6 == (x.s < 0 ? 3 : 2)) : rd > 5 || rd == 5 && (rm6 == 4 || r || rm6 == 6 && (i > 0 ? j > 0 ? n / pows10[d - j] : 0 : xc[ni - 1]) % 10 & 1 || rm6 == (x.s < 0 ? 8 : 7));
             if (sd < 1 || !xc[0]) {
               xc.length = 0;
               if (r) {
@@ -10516,15 +10516,15 @@ var require_bignumber = __commonJS((exports, module) => {
       P.comparedTo = function(y, b) {
         return compare(this, new BigNumber2(y, b));
       };
-      P.decimalPlaces = P.dp = function(dp, rm5) {
+      P.decimalPlaces = P.dp = function(dp, rm6) {
         var c, n, v, x = this;
         if (dp != null) {
           intCheck(dp, 0, MAX);
-          if (rm5 == null)
-            rm5 = ROUNDING_MODE;
+          if (rm6 == null)
+            rm6 = ROUNDING_MODE;
           else
-            intCheck(rm5, 0, 8);
-          return round(new BigNumber2(x), dp + x.e + 1, rm5);
+            intCheck(rm6, 0, 8);
+          return round(new BigNumber2(x), dp + x.e + 1, rm6);
         }
         if (!(c = x.c))
           return null;
@@ -10623,13 +10623,13 @@ var require_bignumber = __commonJS((exports, module) => {
           y = ONE.div(y);
         return m ? y.mod(m) : k ? round(y, POW_PRECISION, ROUNDING_MODE, more) : y;
       };
-      P.integerValue = function(rm5) {
+      P.integerValue = function(rm6) {
         var n = new BigNumber2(this);
-        if (rm5 == null)
-          rm5 = ROUNDING_MODE;
+        if (rm6 == null)
+          rm6 = ROUNDING_MODE;
         else
-          intCheck(rm5, 0, 8);
-        return round(n, n.e + 1, rm5);
+          intCheck(rm6, 0, 8);
+        return round(n, n.e + 1, rm6);
       };
       P.isEqualTo = P.eq = function(y, b) {
         return compare(this, new BigNumber2(y, b)) === 0;
@@ -10866,15 +10866,15 @@ var require_bignumber = __commonJS((exports, module) => {
         }
         return normalise(y, xc, ye);
       };
-      P.precision = P.sd = function(sd, rm5) {
+      P.precision = P.sd = function(sd, rm6) {
         var c, n, v, x = this;
         if (sd != null && sd !== !!sd) {
           intCheck(sd, 1, MAX);
-          if (rm5 == null)
-            rm5 = ROUNDING_MODE;
+          if (rm6 == null)
+            rm6 = ROUNDING_MODE;
           else
-            intCheck(rm5, 0, 8);
-          return round(new BigNumber2(x), sd, rm5);
+            intCheck(rm6, 0, 8);
+          return round(new BigNumber2(x), sd, rm6);
         }
         if (!(c = x.c))
           return null;
@@ -10951,36 +10951,36 @@ var require_bignumber = __commonJS((exports, module) => {
         }
         return round(r, r.e + DECIMAL_PLACES + 1, ROUNDING_MODE, m);
       };
-      P.toExponential = function(dp, rm5) {
+      P.toExponential = function(dp, rm6) {
         if (dp != null) {
           intCheck(dp, 0, MAX);
           dp++;
         }
-        return format(this, dp, rm5, 1);
+        return format(this, dp, rm6, 1);
       };
-      P.toFixed = function(dp, rm5) {
+      P.toFixed = function(dp, rm6) {
         if (dp != null) {
           intCheck(dp, 0, MAX);
           dp = dp + this.e + 1;
         }
-        return format(this, dp, rm5);
+        return format(this, dp, rm6);
       };
-      P.toFormat = function(dp, rm5, format2) {
+      P.toFormat = function(dp, rm6, format2) {
         var str, x = this;
         if (format2 == null) {
-          if (dp != null && rm5 && typeof rm5 == "object") {
-            format2 = rm5;
-            rm5 = null;
+          if (dp != null && rm6 && typeof rm6 == "object") {
+            format2 = rm6;
+            rm6 = null;
           } else if (dp && typeof dp == "object") {
             format2 = dp;
-            dp = rm5 = null;
+            dp = rm6 = null;
           } else {
             format2 = FORMAT;
           }
         } else if (typeof format2 != "object") {
           throw Error(bignumberError + "Argument not an object: " + format2);
         }
-        str = x.toFixed(dp, rm5);
+        str = x.toFixed(dp, rm6);
         if (x.c) {
           var i, arr = str.split("."), g1 = +format2.groupSize, g2 = +format2.secondaryGroupSize, groupSeparator = format2.groupSeparator || "", intPart = arr[0], fractionPart = arr[1], isNeg = x.s < 0, intDigits = isNeg ? intPart.slice(1) : intPart, len = intDigits.length;
           if (g2) {
@@ -11048,10 +11048,10 @@ var require_bignumber = __commonJS((exports, module) => {
       P.toNumber = function() {
         return +valueOf(this);
       };
-      P.toPrecision = function(sd, rm5) {
+      P.toPrecision = function(sd, rm6) {
         if (sd != null)
           intCheck(sd, 1, MAX);
-        return format(this, sd, rm5, 2);
+        return format(this, sd, rm6, 2);
       };
       P.toString = function(b) {
         var str, n = this, s = n.s, e = n.e;
@@ -14526,7 +14526,7 @@ var require_getCredentials = __commonJS((exports) => {
   var fs = __require("fs");
   var util_1 = __require("util");
   var errorWithCode_1 = require_errorWithCode();
-  var readFile3 = fs.readFile ? (0, util_1.promisify)(fs.readFile) : async () => {
+  var readFile4 = fs.readFile ? (0, util_1.promisify)(fs.readFile) : async () => {
     throw new errorWithCode_1.ErrorWithCode("use key rather than keyFile.", "MISSING_CREDENTIALS");
   };
   var ExtensionFiles;
@@ -14545,7 +14545,7 @@ var require_getCredentials = __commonJS((exports) => {
       this.keyFilePath = keyFilePath;
     }
     async getCredentials() {
-      const key = await readFile3(this.keyFilePath, "utf8");
+      const key = await readFile4(this.keyFilePath, "utf8");
       let body;
       try {
         body = JSON.parse(key);
@@ -14568,7 +14568,7 @@ var require_getCredentials = __commonJS((exports) => {
       this.keyFilePath = keyFilePath;
     }
     async getCredentials() {
-      const privateKey = await readFile3(this.keyFilePath, "utf8");
+      const privateKey = await readFile4(this.keyFilePath, "utf8");
       return { privateKey };
     }
   }
@@ -15766,7 +15766,7 @@ var require_filesubjecttokensupplier = __commonJS((exports) => {
   exports.FileSubjectTokenSupplier = undefined;
   var util_1 = __require("util");
   var fs = __require("fs");
-  var readFile3 = (0, util_1.promisify)(fs.readFile ?? (() => {}));
+  var readFile4 = (0, util_1.promisify)(fs.readFile ?? (() => {}));
   var realpath = (0, util_1.promisify)(fs.realpath ?? (() => {}));
   var lstat = (0, util_1.promisify)(fs.lstat ?? (() => {}));
 
@@ -15793,7 +15793,7 @@ var require_filesubjecttokensupplier = __commonJS((exports) => {
         throw err;
       }
       let subjectToken;
-      const rawText = await readFile3(parsedFilePath, { encoding: "utf8" });
+      const rawText = await readFile4(parsedFilePath, { encoding: "utf8" });
       if (this.formatType === "text") {
         subjectToken = rawText;
       } else if (this.formatType === "json" && this.subjectTokenFieldName) {
@@ -22280,6 +22280,7 @@ var apps = sqliteTable("apps", {
   iosBundleId: text("ios_bundle_id").notNull().default(""),
   iosAppStoreId: text("ios_app_store_id").notNull().default(""),
   androidApplicationId: text("android_application_id").notNull().default(""),
+  webUrl: text("web_url").notNull().default(""),
   appiumCaps: text("appium_caps").notNull().default("[]"),
   createdAt: integer("created_at").notNull(),
   updatedAt: integer("updated_at").notNull()
@@ -22338,6 +22339,8 @@ var runs = sqliteTable("runs", {
   requestedLane: text("requested_lane"),
   lane: text("lane"),
   laneWarning: text("lane_warning"),
+  browser: text("browser"),
+  viewport: text("viewport"),
   recordVideo: integer("record_video").notNull().default(0),
   error: text("error"),
   createdAt: integer("created_at").notNull(),
@@ -22389,6 +22392,7 @@ function ensureSchema(sqlite) {
 			ios_bundle_id TEXT NOT NULL DEFAULT '',
 			ios_app_store_id TEXT NOT NULL DEFAULT '',
 			android_application_id TEXT NOT NULL DEFAULT '',
+			web_url TEXT NOT NULL DEFAULT '',
 			appium_caps TEXT NOT NULL DEFAULT '[]',
 			created_at INTEGER NOT NULL,
 			updated_at INTEGER NOT NULL
@@ -22516,6 +22520,7 @@ function ensureSchema(sqlite) {
   migrateProvidersTable(sqlite);
   migrateAppsPrefix(sqlite);
   migrateAppsKnowledge(sqlite);
+  migrateAppsWebUrl(sqlite);
   migrateCaseScripts(sqlite);
   migrateRunExecutionMode(sqlite);
   migrateRunScreenMode(sqlite);
@@ -22558,6 +22563,8 @@ function migrateRunLane(sqlite) {
   addColumnIfMissing(sqlite, "runs", "requested_lane", "requested_lane TEXT", runCols);
   addColumnIfMissing(sqlite, "runs", "lane", "lane TEXT", runCols);
   addColumnIfMissing(sqlite, "runs", "lane_warning", "lane_warning TEXT", runCols);
+  addColumnIfMissing(sqlite, "runs", "browser", "browser TEXT", runCols);
+  addColumnIfMissing(sqlite, "runs", "viewport", "viewport TEXT", runCols);
 }
 function migrateRecording(sqlite) {
   const caseCols = tableColumns(sqlite, "cases");
@@ -22684,6 +22691,12 @@ function migrateAppsKnowledge(sqlite) {
     return;
   addColumnIfMissing(sqlite, "apps", "knowledge", "knowledge TEXT NOT NULL DEFAULT ''", existing);
 }
+function migrateAppsWebUrl(sqlite) {
+  const existing = tableColumns(sqlite, "apps");
+  if (existing.size === 0)
+    return;
+  addColumnIfMissing(sqlite, "apps", "web_url", "web_url TEXT NOT NULL DEFAULT ''", existing);
+}
 function getCatalogDbPath() {
   return process.env.YOQA_DB_PATH ?? DEFAULT_DB_PATH;
 }
@@ -26688,13 +26701,20 @@ var healthResponseSchema = exports_external.object({
   version: exports_external.string(),
   uptimeMs: exports_external.number().nonnegative()
 });
-var devicePlatformSchema = exports_external.union([exports_external.literal("ios"), exports_external.literal("android")]);
+var devicePlatformSchema = exports_external.union([
+  exports_external.literal("ios"),
+  exports_external.literal("android"),
+  exports_external.literal("web")
+]);
 var laneNameSchema = exports_external.literal("direct");
 var deviceKindSchema = exports_external.union([
   exports_external.literal("physical"),
   exports_external.literal("simulator"),
-  exports_external.literal("emulator")
+  exports_external.literal("emulator"),
+  exports_external.literal("browser")
 ]);
+var VIEWPORT_PRESET_NAMES = ["desktop", "mobile"];
+var viewportPresetSchema = exports_external.enum(VIEWPORT_PRESET_NAMES);
 var deviceSchema = exports_external.object({
   id: exports_external.string().min(1),
   name: exports_external.string().min(1),
@@ -26834,13 +26854,15 @@ var catalogAppSchema = exports_external.object({
   iosBundleId: exports_external.string(),
   iosAppStoreId: exports_external.string(),
   androidApplicationId: exports_external.string(),
+  webUrl: exports_external.string().default(""),
   capabilities: exports_external.array(capabilitySchema),
   createdAt: exports_external.number().int().nonnegative(),
   updatedAt: exports_external.number().int().nonnegative()
 });
 var createAppRequestSchema = exports_external.object({
   name: exports_external.string().min(1),
-  prefix: exports_external.string().min(1).optional()
+  prefix: exports_external.string().min(1).optional(),
+  webUrl: exports_external.string().optional()
 });
 var updateAppRequestSchema = exports_external.object({
   name: exports_external.string().min(1).optional(),
@@ -26850,6 +26872,7 @@ var updateAppRequestSchema = exports_external.object({
   iosBundleId: exports_external.string().optional(),
   iosAppStoreId: exports_external.string().optional(),
   androidApplicationId: exports_external.string().optional(),
+  webUrl: exports_external.string().optional(),
   capabilities: exports_external.array(capabilitySchema).optional()
 });
 var listAppsResponseSchema = exports_external.object({
@@ -26898,6 +26921,25 @@ var caseScriptDragSchema = exports_external.object({
   durationMs: exports_external.number().min(50).max(5000).optional(),
   reason: exports_external.string().optional()
 });
+var KEY_NAMES = [
+  "Enter",
+  "Tab",
+  "Escape",
+  "Backspace",
+  "Delete",
+  "ArrowUp",
+  "ArrowDown",
+  "ArrowLeft",
+  "ArrowRight",
+  "Home",
+  "End",
+  "PageUp",
+  "PageDown",
+  "Space"
+];
+var keyNameSchema = exports_external.enum(KEY_NAMES);
+var KEY_MODIFIERS = ["Shift", "Control", "Alt", "Meta"];
+var keyModifierSchema = exports_external.enum(KEY_MODIFIERS);
 function caseScriptAppIdSchema(type) {
   return exports_external.object({
     type: exports_external.literal(type),
@@ -26905,60 +26947,99 @@ function caseScriptAppIdSchema(type) {
     reason: exports_external.string().optional()
   });
 }
+var caseScriptTypeSchema = exports_external.object({
+  type: exports_external.literal("type"),
+  text: exports_external.string(),
+  reason: exports_external.string().optional()
+});
+var caseScriptWaitSchema = exports_external.object({
+  type: exports_external.literal("wait"),
+  ms: exports_external.number().min(0).max(1e4),
+  reason: exports_external.string().optional()
+});
+var caseScriptAssertionSchema = exports_external.union([exports_external.literal("visible"), exports_external.literal("not-visible")]).default("visible");
+var caseScriptAssertSchema = exports_external.object({
+  type: exports_external.literal("assert"),
+  assertion: caseScriptAssertionSchema,
+  text: exports_external.string().min(1),
+  timeoutMs: exports_external.number().min(0).max(120000).optional(),
+  reason: exports_external.string().optional()
+});
+var caseScriptAlertSchema = exports_external.object({
+  type: exports_external.literal("alert"),
+  alertAction: exports_external.union([exports_external.literal("accept"), exports_external.literal("dismiss")]).default("accept"),
+  reason: exports_external.string().optional()
+});
+var caseScriptBackgroundAppSchema = exports_external.object({
+  type: exports_external.literal("background-app"),
+  seconds: exports_external.number().min(0).max(120).optional(),
+  reason: exports_external.string().optional()
+});
+var caseScriptOpenUrlSchema = exports_external.object({
+  type: exports_external.literal("open-url"),
+  url: exports_external.string().min(1),
+  reason: exports_external.string().optional()
+});
+var caseScriptKeySchema = exports_external.object({
+  type: exports_external.literal("key"),
+  key: keyNameSchema,
+  modifiers: exports_external.array(keyModifierSchema).min(1).optional(),
+  reason: exports_external.string().optional()
+});
+var caseScriptGestureSchema = exports_external.union([
+  caseScriptTapSchema,
+  caseScriptSwipeSchema,
+  caseScriptDragSchema,
+  caseScriptTypeSchema,
+  caseScriptWaitSchema,
+  caseScriptAssertSchema,
+  caseScriptAlertSchema,
+  caseScriptAppIdSchema("activate-app"),
+  caseScriptAppIdSchema("terminate-app"),
+  caseScriptAppIdSchema("restart-app"),
+  caseScriptBackgroundAppSchema,
+  caseScriptOpenUrlSchema,
+  caseScriptKeySchema
+]);
+var BRANCH_DEFAULT_TIMEOUT_MS = 2000;
+var caseScriptStepsSchema = exports_external.array(exports_external.lazy(() => caseScriptActionSchema));
+var caseScriptBranchSchema = exports_external.object({
+  type: exports_external.literal("branch"),
+  text: exports_external.string().min(1).optional(),
+  id: exports_external.string().min(1).optional(),
+  assertion: caseScriptAssertionSchema,
+  timeoutMs: exports_external.number().min(0).max(120000).optional(),
+  then: caseScriptStepsSchema.min(1),
+  else: caseScriptStepsSchema.optional().transform((actions) => actions?.length ? actions : undefined),
+  reason: exports_external.string().optional()
+}).superRefine((value, ctx) => {
+  if (value.text == null === (value.id == null)) {
+    ctx.addIssue({
+      code: exports_external.ZodIssueCode.custom,
+      message: "branch requires exactly one of text or id"
+    });
+  }
+});
+var caseScriptActionSchema = exports_external.union([
+  caseScriptGestureSchema,
+  caseScriptBranchSchema
+]);
 var caseScriptActionSchemaByType = {
   tap: caseScriptTapSchema,
   swipe: caseScriptSwipeSchema,
   drag: caseScriptDragSchema,
-  type: exports_external.object({
-    type: exports_external.literal("type"),
-    text: exports_external.string(),
-    reason: exports_external.string().optional()
-  }),
-  wait: exports_external.object({
-    type: exports_external.literal("wait"),
-    ms: exports_external.number().min(0).max(1e4),
-    reason: exports_external.string().optional()
-  }),
-  assert: exports_external.object({
-    type: exports_external.literal("assert"),
-    assertion: exports_external.union([exports_external.literal("visible"), exports_external.literal("not-visible")]).default("visible"),
-    text: exports_external.string().min(1),
-    timeoutMs: exports_external.number().min(0).max(120000).optional(),
-    reason: exports_external.string().optional()
-  }),
-  alert: exports_external.object({
-    type: exports_external.literal("alert"),
-    alertAction: exports_external.union([exports_external.literal("accept"), exports_external.literal("dismiss")]).default("accept"),
-    reason: exports_external.string().optional()
-  }),
+  type: caseScriptTypeSchema,
+  wait: caseScriptWaitSchema,
+  assert: caseScriptAssertSchema,
+  alert: caseScriptAlertSchema,
   "activate-app": caseScriptAppIdSchema("activate-app"),
   "terminate-app": caseScriptAppIdSchema("terminate-app"),
   "restart-app": caseScriptAppIdSchema("restart-app"),
-  "background-app": exports_external.object({
-    type: exports_external.literal("background-app"),
-    seconds: exports_external.number().min(0).max(120).optional(),
-    reason: exports_external.string().optional()
-  }),
-  "open-url": exports_external.object({
-    type: exports_external.literal("open-url"),
-    url: exports_external.string().min(1),
-    reason: exports_external.string().optional()
-  })
+  "background-app": caseScriptBackgroundAppSchema,
+  "open-url": caseScriptOpenUrlSchema,
+  key: caseScriptKeySchema,
+  branch: caseScriptBranchSchema
 };
-var caseScriptActionSchema = exports_external.union([
-  caseScriptActionSchemaByType.tap,
-  caseScriptActionSchemaByType.swipe,
-  caseScriptActionSchemaByType.drag,
-  caseScriptActionSchemaByType.type,
-  caseScriptActionSchemaByType.wait,
-  caseScriptActionSchemaByType.assert,
-  caseScriptActionSchemaByType.alert,
-  caseScriptActionSchemaByType["activate-app"],
-  caseScriptActionSchemaByType["terminate-app"],
-  caseScriptActionSchemaByType["restart-app"],
-  caseScriptActionSchemaByType["background-app"],
-  caseScriptActionSchemaByType["open-url"]
-]);
 var caseScriptSchema = exports_external.object({
   version: exports_external.literal(1),
   sourceRunId: exports_external.string().min(1).optional(),
@@ -27269,6 +27350,8 @@ var runSchema = exports_external.object({
   screenMode: runScreenModeSchema.optional(),
   lane: laneNameSchema.optional(),
   laneWarning: exports_external.string().min(1).optional(),
+  browser: exports_external.string().min(1).optional(),
+  viewport: viewportPresetSchema.optional(),
   error: exports_external.string().nullable(),
   createdAt: exports_external.number().int().nonnegative(),
   startedAt: exports_external.number().int().nonnegative().nullable(),
@@ -27287,7 +27370,8 @@ var connectDeviceRequestSchema = exports_external.object({
   platform: devicePlatformSchema,
   bundleId: exports_external.string().min(1).optional(),
   appPackage: exports_external.string().min(1).optional(),
-  lane: exports_external.union([laneNameSchema, exports_external.literal("auto")]).optional()
+  lane: exports_external.union([laneNameSchema, exports_external.literal("auto")]).optional(),
+  viewport: viewportPresetSchema.optional()
 });
 var streamStateSchema = exports_external.union([
   exports_external.literal("ready"),
@@ -27305,7 +27389,8 @@ var activeDeviceResponseSchema = exports_external.object({
   heldByRun: exports_external.boolean().optional(),
   heldByRunId: exports_external.string().min(1).optional(),
   lane: laneNameSchema.optional(),
-  laneWarning: exports_external.string().min(1).optional()
+  laneWarning: exports_external.string().min(1).optional(),
+  viewport: viewportPresetSchema.optional()
 });
 var retargetDeviceRequestSchema = exports_external.object({
   bundleId: exports_external.string().min(1).optional(),
@@ -27352,7 +27437,8 @@ var actionKindSchema = exports_external.union([
   exports_external.literal("restart-app"),
   exports_external.literal("background-app"),
   exports_external.literal("open-url"),
-  exports_external.literal("alert")
+  exports_external.literal("alert"),
+  exports_external.literal("key")
 ]);
 var actionRequestSchema = exports_external.object({
   kind: actionKindSchema,
@@ -27370,6 +27456,8 @@ var actionRequestSchema = exports_external.object({
   url: exports_external.string().optional(),
   alertAction: exports_external.union([exports_external.literal("accept"), exports_external.literal("dismiss")]).optional(),
   seconds: exports_external.number().optional(),
+  key: keyNameSchema.optional(),
+  modifiers: exports_external.array(keyModifierSchema).optional(),
   screenshot: exports_external.boolean().optional(),
   settleMs: exports_external.number().int().min(0).max(1e4).optional(),
   fullImage: exports_external.boolean().optional(),
@@ -27451,6 +27539,58 @@ var listBuildsResponseSchema = exports_external.object({
 
 // ../../packages/runner-client/src/wait-for-run.ts
 var DEFAULT_WAIT_FOR_RUN_TIMEOUT_MS = 30 * 60 * 1000;
+
+// ../../node_modules/yaml/dist/index.js
+var composer = require_composer();
+var Document = require_Document();
+var Schema2 = require_Schema();
+var errors2 = require_errors();
+var Alias = require_Alias();
+var identity = require_identity();
+var Pair = require_Pair();
+var Scalar = require_Scalar();
+var YAMLMap = require_YAMLMap();
+var YAMLSeq = require_YAMLSeq();
+var cst = require_cst();
+var lexer = require_lexer();
+var lineCounter = require_line_counter();
+var parser = require_parser();
+var publicApi = require_public_api();
+var visit = require_visit();
+var $Composer = composer.Composer;
+var $Document = Document.Document;
+var $Schema = Schema2.Schema;
+var $YAMLError = errors2.YAMLError;
+var $YAMLParseError = errors2.YAMLParseError;
+var $YAMLWarning = errors2.YAMLWarning;
+var $Alias = Alias.Alias;
+var $isAlias = identity.isAlias;
+var $isCollection = identity.isCollection;
+var $isDocument = identity.isDocument;
+var $isMap = identity.isMap;
+var $isNode = identity.isNode;
+var $isPair = identity.isPair;
+var $isScalar = identity.isScalar;
+var $isSeq = identity.isSeq;
+var $Pair = Pair.Pair;
+var $Scalar = Scalar.Scalar;
+var $YAMLMap = YAMLMap.YAMLMap;
+var $YAMLSeq = YAMLSeq.YAMLSeq;
+var $Lexer = lexer.Lexer;
+var $LineCounter = lineCounter.LineCounter;
+var $Parser = parser.Parser;
+var $parse = publicApi.parse;
+var $parseAllDocuments = publicApi.parseAllDocuments;
+var $parseDocument = publicApi.parseDocument;
+var $stringify = publicApi.stringify;
+var $visit = visit.visit;
+var $visitAsync = visit.visitAsync;
+
+// ../../packages/runner-client/src/keys.ts
+function formatKeyChord(key, modifiers = []) {
+  return [...modifiers, key].join("+");
+}
+
 // ../../packages/runner-client/src/xml-entities.ts
 var NAMED = {
   amp: "&",
@@ -27482,6 +27622,10 @@ function shellSingleQuote(value) {
 }
 function formatActionShellLine(action) {
   const parts = ["yoqa", "action", action.kind];
+  if (action.kind === "key" && action.key)
+    parts.push(action.key);
+  if (action.modifiers?.length)
+    parts.push("--modifiers", action.modifiers.join(","));
   if (action.id) {
     parts.push("--id", shellSingleQuote(action.id));
   }
@@ -27522,8 +27666,14 @@ function formatSleepShellLine(seconds) {
   const rounded = Number.isInteger(safe) ? String(safe) : String(Number(safe.toFixed(3)));
   return `sleep ${rounded}`;
 }
+function assertTargetFlags(target) {
+  return [
+    ...target.text != null ? ["--text", shellSingleQuote(target.text.trim())] : [],
+    ...target.id != null ? ["--id", shellSingleQuote(target.id.trim())] : []
+  ];
+}
 function formatAssertShellLine(input) {
-  const parts = ["yoqa", "assert", input.assertion, "--text", shellSingleQuote(input.text.trim())];
+  const parts = ["yoqa", "assert", input.assertion, ...assertTargetFlags(input)];
   const timeout = input.timeoutSeconds ?? 5;
   if (timeout !== 5) {
     parts.push("--timeout", String(timeout));
@@ -27551,6 +27701,11 @@ function screenHasText(elements, text2) {
     return label.includes(needle) || type.includes(needle);
   });
 }
+function screenHasTarget(elements, target) {
+  if (target.id != null)
+    return findElementById(elements, target.id) != null;
+  return screenHasText(elements, target.text ?? "");
+}
 function findElementByLabel(elements, label) {
   const needle = normalizedLabel(label);
   if (!needle)
@@ -27588,63 +27743,104 @@ function elementCenterNorm(element) {
     y: Math.round(element.y + element.height / 2)
   };
 }
-// ../../node_modules/yaml/dist/index.js
-var composer = require_composer();
-var Document = require_Document();
-var Schema2 = require_Schema();
-var errors2 = require_errors();
-var Alias = require_Alias();
-var identity = require_identity();
-var Pair = require_Pair();
-var Scalar = require_Scalar();
-var YAMLMap = require_YAMLMap();
-var YAMLSeq = require_YAMLSeq();
-var cst = require_cst();
-var lexer = require_lexer();
-var lineCounter = require_line_counter();
-var parser = require_parser();
-var publicApi = require_public_api();
-var visit = require_visit();
-var $Composer = composer.Composer;
-var $Document = Document.Document;
-var $Schema = Schema2.Schema;
-var $YAMLError = errors2.YAMLError;
-var $YAMLParseError = errors2.YAMLParseError;
-var $YAMLWarning = errors2.YAMLWarning;
-var $Alias = Alias.Alias;
-var $isAlias = identity.isAlias;
-var $isCollection = identity.isCollection;
-var $isDocument = identity.isDocument;
-var $isMap = identity.isMap;
-var $isNode = identity.isNode;
-var $isPair = identity.isPair;
-var $isScalar = identity.isScalar;
-var $isSeq = identity.isSeq;
-var $Pair = Pair.Pair;
-var $Scalar = Scalar.Scalar;
-var $YAMLMap = YAMLMap.YAMLMap;
-var $YAMLSeq = YAMLSeq.YAMLSeq;
-var $Lexer = lexer.Lexer;
-var $LineCounter = lineCounter.LineCounter;
-var $Parser = parser.Parser;
-var $parse = publicApi.parse;
-var $parseAllDocuments = publicApi.parseAllDocuments;
-var $parseDocument = publicApi.parseDocument;
-var $stringify = publicApi.stringify;
-var $visit = visit.visit;
-var $visitAsync = visit.visitAsync;
 
 // ../../packages/runner-client/src/case-script-file.ts
-var ACTION_TYPES = Object.keys(caseScriptActionSchemaByType);
-var TEXT_SHORT_FORM_FIELDS = new Set(["label", "text", "alertAction", "url", "appId"]);
+var ACTION_TYPES = Object.keys(caseScriptActionSchemaByType).filter((type) => type !== "branch");
+var BRANCH_KEY = "if";
+var ITEM_NAMES = [...ACTION_TYPES, BRANCH_KEY];
+var TEXT_SHORT_FORM_FIELDS = new Set(["label", "text", "alertAction", "url", "appId", "key"]);
 var TOP_LEVEL_KEYS = new Set(["version", "name", "sourceRunId", "savedAt", "actions"]);
+
+// ../../packages/runner-client/src/screen-check.ts
+var SCREEN_CHECK_POLL_MS = 400;
+function abortError() {
+  return Object.assign(new Error("Aborted"), { name: "AbortError" });
+}
+function describeScreenCheck(check) {
+  return check.id != null ? `${check.assertion} id: ${check.id}` : `${check.assertion}: ${check.text}`;
+}
+function screenCheckMissMessage(options) {
+  const seconds = Math.round(options.timeoutMs / 1000);
+  const [kind, target] = options.id != null ? ["id", options.id] : ["text", options.text];
+  return options.assertion === "visible" ? `Expected visible ${kind} not found within ${seconds}s: ${target}` : `Unexpected ${kind} still visible after ${seconds}s: ${target}`;
+}
+async function checkScreen(options) {
+  const pollMs = options.pollMs ?? SCREEN_CHECK_POLL_MS;
+  const deadline = options.now() + options.timeoutMs;
+  for (;; ) {
+    if (options.isAborted?.())
+      throw abortError();
+    let readError = null;
+    try {
+      const { elements } = await options.readScreen();
+      const found = screenHasTarget(elements, options);
+      if (options.assertion === "visible" ? found : !found)
+        return { met: true };
+    } catch (error) {
+      if (options.isDeadSession?.(error))
+        throw error;
+      readError = error;
+    }
+    if (options.now() >= deadline) {
+      if (readError) {
+        const seconds = Math.round(options.timeoutMs / 1000);
+        const message = readError instanceof Error ? readError.message : String(readError);
+        throw new Error(`Could not read the screen within ${seconds}s: ${message}`);
+      }
+      return { met: false };
+    }
+    await options.sleep(pollMs);
+  }
+}
+
+// ../../packages/runner-client/src/script-format.ts
+var BRANCH_HELPER = "yoqa_branch";
+var BRANCH_HELPER_LINES = [
+  "# A Branch's check: 0 runs `then`, 1 runs `else`, anything else stops the script.",
+  `${BRANCH_HELPER}() {`,
+  "  local status=0",
+  '  "$@" || status=$?',
+  '  [ "$status" -le 1 ] || exit "$status"',
+  '  return "$status"',
+  "}",
+  ""
+];
+// ../../packages/runner-client/src/viewport.ts
+var VIEWPORT_PRESETS = {
+  desktop: { name: "desktop", width: 1280, height: 800, deviceScaleFactor: 1, mobile: false },
+  mobile: { name: "mobile", width: 390, height: 844, deviceScaleFactor: 3, mobile: true }
+};
+var DEFAULT_VIEWPORT_PRESET = "desktop";
+// ../../packages/runner-client/src/app-start-target.ts
+function appStartTarget(app, platform) {
+  switch (platform) {
+    case "ios":
+      return app?.iosBundleId.trim() || undefined;
+    case "android":
+      return app?.androidApplicationId.trim() || undefined;
+    case "web":
+      return app?.webUrl.trim() || undefined;
+  }
+}
+function startTargetRequest(platform, target) {
+  if (!target)
+    return {};
+  switch (platform) {
+    case "ios":
+      return { bundleId: target };
+    case "android":
+      return { appPackage: target };
+    case "web":
+      return {};
+  }
+}
 // src/domains/builds/application.ts
 import { basename, extname } from "path";
 
 // src/domains/devices/application.ts
-import { mkdtemp, readFile, rm } from "fs/promises";
-import { tmpdir } from "os";
-import { join as join4 } from "path";
+import { mkdtemp as mkdtemp2, readFile as readFile2, rm as rm2 } from "fs/promises";
+import { tmpdir as tmpdir2 } from "os";
+import { join as join5 } from "path";
 
 // src/domains/devices/android-identity.ts
 function matchAndroidIdentity(deviceId, connected, knownAvds = []) {
@@ -27672,6 +27868,153 @@ function parseAdbEmuAvdName(stdout) {
   return name || null;
 }
 
+// src/domains/devices/chromium-browsers.ts
+import { constants } from "fs";
+import { access, mkdtemp, readFile, rm } from "fs/promises";
+import { homedir as homedir4, tmpdir } from "os";
+import { join as join4 } from "path";
+var KNOWN_BROWSERS = [
+  { id: "web-chrome", name: "Google Chrome", app: "Google Chrome" },
+  { id: "web-edge", name: "Microsoft Edge", app: "Microsoft Edge" },
+  { id: "web-brave", name: "Brave Browser", app: "Brave Browser" },
+  { id: "web-chromium", name: "Chromium", app: "Chromium" }
+];
+function installedBrowserIdOf(deviceId) {
+  return KNOWN_BROWSERS.find((browser) => browser.id === deviceId)?.id ?? null;
+}
+function discoveryDeps() {
+  return {
+    platform: process.platform,
+    home: homedir4(),
+    isExecutable: (path) => access(path, constants.X_OK).then(() => true, () => false),
+    readText: (path) => readFile(path, "utf8")
+  };
+}
+var VERSION_RE = /<key>CFBundleShortVersionString<\/key>\s*<string>([^<]+)<\/string>/;
+async function bundleVersion(appPath, deps) {
+  const plist = await deps.readText(join4(appPath, "Contents/Info.plist")).catch(() => "");
+  return VERSION_RE.exec(plist)?.[1]?.trim() || null;
+}
+async function findInstalledBrowsers(deps = discoveryDeps()) {
+  if (deps.platform !== "darwin")
+    return [];
+  const roots = ["/Applications", join4(deps.home, "Applications")];
+  const found = await Promise.all(KNOWN_BROWSERS.map(async ({ id, name, app }) => {
+    for (const root of roots) {
+      const appPath = join4(root, `${app}.app`);
+      const executable = join4(appPath, "Contents/MacOS", app);
+      if (!await deps.isExecutable(executable))
+        continue;
+      return { id, name, version: await bundleVersion(appPath, deps), executable };
+    }
+    return null;
+  }));
+  return found.filter((browser) => browser !== null);
+}
+var running = new Set;
+async function listWebDevices(options = {}, deps = discoveryDeps()) {
+  const includeUnavailable = options.includeUnavailable ?? true;
+  const devices = [];
+  for (const browser of await findInstalledBrowsers(deps)) {
+    const isRunning = running.has(browser.id);
+    if (!includeUnavailable && !isRunning)
+      continue;
+    devices.push({
+      id: browser.id,
+      name: browser.name,
+      osVersion: browser.version ?? "unknown version",
+      platform: "web",
+      kind: "browser",
+      state: isRunning ? "running" : "not running"
+    });
+  }
+  return devices;
+}
+var READY_TIMEOUT_MS = 15000;
+var READY_POLL_MS = 50;
+var STOP_GRACE_MS = 2000;
+var LAUNCH_FLAGS = [
+  "--remote-debugging-port=0",
+  "--no-first-run",
+  "--no-default-browser-check",
+  "--disable-search-engine-choice-screen",
+  "--disable-sync",
+  "--disable-default-apps",
+  "--use-mock-keychain",
+  "--password-store=basic"
+];
+function spawnBrowser(command) {
+  return Bun.spawn(command, { stdin: "ignore", stdout: "ignore", stderr: "pipe" });
+}
+async function readActivePort(profileDir) {
+  const text2 = await readFile(join4(profileDir, "DevToolsActivePort"), "utf8").catch(() => "");
+  const [port, path] = text2.split(`
+`).map((line) => line.trim());
+  if (!port || !/^\d+$/.test(port) || !path?.startsWith("/"))
+    return null;
+  return `ws://127.0.0.1:${port}${path}`;
+}
+async function launchChromium(browser, deps = {}) {
+  const spawn = deps.spawn ?? spawnBrowser;
+  const readyTimeoutMs = deps.readyTimeoutMs ?? READY_TIMEOUT_MS;
+  const profileDir = await mkdtemp(join4(tmpdir(), "yoqa-web-"));
+  const removeProfile = () => rm(profileDir, { recursive: true, force: true });
+  let proc;
+  try {
+    proc = spawn([
+      browser.executable,
+      `--user-data-dir=${profileDir}`,
+      ...LAUNCH_FLAGS,
+      "about:blank"
+    ]);
+  } catch (error) {
+    await removeProfile();
+    throw error;
+  }
+  let hasExited = false;
+  const exited = proc.exited.then((code) => {
+    hasExited = true;
+    running.delete(browser.id);
+    return code;
+  });
+  const stderr = proc.stderr ? new Response(proc.stderr).text().catch(() => "") : null;
+  let stopping = null;
+  const stop = () => {
+    stopping ??= (async () => {
+      if (!hasExited) {
+        proc.kill("SIGTERM");
+        const exitedInTime = await Promise.race([
+          exited.then(() => true),
+          Bun.sleep(STOP_GRACE_MS).then(() => false)
+        ]);
+        if (!exitedInTime)
+          proc.kill("SIGKILL");
+      }
+      running.delete(browser.id);
+      await removeProfile();
+    })();
+    return stopping;
+  };
+  const deadline = Date.now() + readyTimeoutMs;
+  while (true) {
+    const socketUrl = await readActivePort(profileDir);
+    if (socketUrl) {
+      running.add(browser.id);
+      return { socketUrl, profileDir, exited, stop };
+    }
+    if (hasExited) {
+      await stop();
+      const output = (await stderr ?? "").trim();
+      throw new Error(`${browser.name} exited before it opened a debug port${output ? `: ${output}` : ""}`);
+    }
+    if (Date.now() >= deadline) {
+      await stop();
+      throw new Error(`${browser.name} did not open a debug port within ${readyTimeoutMs} ms`);
+    }
+    await Promise.race([exited, Bun.sleep(READY_POLL_MS)]);
+  }
+}
+
 // src/domains/devices/devicectl.ts
 function developerMode(value) {
   const key = typeof value === "string" ? value : value && typeof value === "object" ? Object.keys(value)[0] : undefined;
@@ -27799,11 +28142,11 @@ async function resolveTool(candidates) {
 }
 async function resolveAdb() {
   const sdk = androidSdkRoot();
-  return resolveTool([...sdk ? [join4(sdk, "platform-tools/adb")] : [], "adb"]);
+  return resolveTool([...sdk ? [join5(sdk, "platform-tools/adb")] : [], "adb"]);
 }
 async function resolveEmulator() {
   const sdk = androidSdkRoot();
-  return resolveTool([...sdk ? [join4(sdk, "emulator/emulator")] : [], "emulator"]);
+  return resolveTool([...sdk ? [join5(sdk, "emulator/emulator")] : [], "emulator"]);
 }
 function formatIosVersion2(version2) {
   const trimmed = version2.trim();
@@ -27901,14 +28244,14 @@ async function readDevicectlDevices(jsonPath) {
   if (exitCode !== 0)
     return null;
   try {
-    return JSON.parse(await readFile(jsonPath, "utf8"));
+    return JSON.parse(await readFile2(jsonPath, "utf8"));
   } catch {
     return null;
   }
 }
 async function listIosPhysicalDevices(includeUnavailable) {
-  const dir = await mkdtemp(join4(tmpdir(), "yoqa-devices-"));
-  const jsonPath = join4(dir, "devices.json");
+  const dir = await mkdtemp2(join5(tmpdir2(), "yoqa-devices-"));
+  const jsonPath = join5(dir, "devices.json");
   try {
     let parsed = await readDevicectlDevices(jsonPath);
     if (parsed === null)
@@ -27921,7 +28264,7 @@ async function listIosPhysicalDevices(includeUnavailable) {
     const devices = parseDevicectlDevices(parsed);
     return includeUnavailable ? devices : devices.filter((device) => !device.unavailableReason);
   } finally {
-    await rm(dir, { recursive: true, force: true });
+    await rm2(dir, { recursive: true, force: true });
   }
 }
 async function listIosDevices(options = {}) {
@@ -27972,18 +28315,18 @@ function humanizeModel(model) {
 }
 async function findAvdConfigPath(avdName) {
   const home = process.env.HOME ?? "";
-  const roots = [join4(home, ".android/avd"), join4(home, "Library/Android/sdk/.android/avd")];
+  const roots = [join5(home, ".android/avd"), join5(home, "Library/Android/sdk/.android/avd")];
   for (const root of roots) {
-    const direct = join4(root, `${avdName}.avd`, "config.ini");
+    const direct = join5(root, `${avdName}.avd`, "config.ini");
     try {
-      await readFile(direct, "utf8");
+      await readFile2(direct, "utf8");
       return direct;
     } catch {}
     try {
       const glob = new Bun.Glob("*.avd/config.ini");
       for await (const match of glob.scan({ cwd: root, onlyFiles: true })) {
-        const path = join4(root, match);
-        const text2 = await readFile(path, "utf8");
+        const path = join5(root, match);
+        const text2 = await readFile2(path, "utf8");
         const idLine = text2.split(`
 `).find((line) => line.startsWith("AvdId="));
         const id = idLine?.slice("AvdId=".length).trim();
@@ -27999,7 +28342,7 @@ async function readAvdConfig(avdName) {
   if (!path)
     return { api: null, deviceName: null };
   try {
-    const text2 = await readFile(path, "utf8");
+    const text2 = await readFile2(path, "utf8");
     const imageLine = text2.split(`
 `).find((line) => line.includes("system-images") && line.includes("android-"));
     const apiMatch = imageLine?.match(/android-([\d.]+)/);
@@ -28140,9 +28483,14 @@ async function listAndroidDevices(options = {}) {
   return [...physical, ...emulators];
 }
 async function listDevices(platform, options = {}) {
-  if (platform === "ios")
-    return listIosDevices(options);
-  return listAndroidDevices(options);
+  switch (platform) {
+    case "ios":
+      return listIosDevices(options);
+    case "android":
+      return listAndroidDevices(options);
+    case "web":
+      return listWebDevices(options);
+  }
 }
 
 // src/domains/builds/application.ts
@@ -28252,32 +28600,44 @@ async function resolveBuildForRun(options) {
 }
 async function installBuildOnDevice(options) {
   const { build, deviceId, platform } = options;
-  if (platform === "ios") {
-    if (build.path.endsWith(".app") || build.path.includes(".app")) {
-      const proc2 = Bun.spawn(["xcrun", "simctl", "install", deviceId, build.path], {
-        stdout: "pipe",
-        stderr: "pipe"
-      });
-      const [stderr2, code2] = await Promise.all([new Response(proc2.stderr).text(), proc2.exited]);
-      if (code2 !== 0) {
-        throw new Error(`simctl install failed: ${stderr2.trim() || `exit ${code2}`}`);
-      }
-      return;
+  switch (platform) {
+    case "ios":
+      return installIosBuild(build, deviceId);
+    case "android":
+      return installAndroidBuild(build, deviceId);
+    case "web":
+      throw new Error("A web device has no Builds to install");
+    default:
+      throw new Error(`Cannot install a build on ${platform}`);
+  }
+}
+async function installIosBuild(build, deviceId) {
+  if (build.path.endsWith(".app") || build.path.includes(".app")) {
+    const proc = Bun.spawn(["xcrun", "simctl", "install", deviceId, build.path], {
+      stdout: "pipe",
+      stderr: "pipe"
+    });
+    const [stderr, code] = await Promise.all([new Response(proc.stderr).text(), proc.exited]);
+    if (code !== 0) {
+      throw new Error(`simctl install failed: ${stderr.trim() || `exit ${code}`}`);
     }
-    const which = Bun.which("ideviceinstaller");
-    if (which && build.path.endsWith(".ipa")) {
-      const proc2 = Bun.spawn([which, "-u", deviceId, "-i", build.path], {
-        stdout: "pipe",
-        stderr: "pipe"
-      });
-      const [stderr2, code2] = await Promise.all([new Response(proc2.stderr).text(), proc2.exited]);
-      if (code2 !== 0) {
-        throw new Error(`ideviceinstaller failed: ${stderr2.trim() || `exit ${code2}`}`);
-      }
-      return;
+    return;
+  }
+  const which = Bun.which("ideviceinstaller");
+  if (which && build.path.endsWith(".ipa")) {
+    const proc = Bun.spawn([which, "-u", deviceId, "-i", build.path], {
+      stdout: "pipe",
+      stderr: "pipe"
+    });
+    const [stderr, code] = await Promise.all([new Response(proc.stderr).text(), proc.exited]);
+    if (code !== 0) {
+      throw new Error(`ideviceinstaller failed: ${stderr.trim() || `exit ${code}`}`);
     }
-    throw new Error(`Cannot install iOS build at ${build.path}. Use a .app on simulator or install .ipa via ideviceinstaller.`);
+    return;
   }
+  throw new Error(`Cannot install iOS build at ${build.path}. Use a .app on simulator or install .ipa via ideviceinstaller.`);
+}
+async function installAndroidBuild(build, deviceId) {
   const identity2 = await resolveAndroidIdentity(deviceId);
   const serial = identity2.udid;
   if (!serial) {
@@ -28491,10 +28851,10 @@ function normalizeVisionJson(value) {
 }
 
 // src/domains/providers/vision-model.ts
-import { mkdtemp as mkdtemp2, readFile as readFile2, rm as rm2, writeFile } from "fs/promises";
-import { homedir as homedir4 } from "os";
-import { tmpdir as tmpdir2 } from "os";
-import { join as join5 } from "path";
+import { mkdtemp as mkdtemp3, readFile as readFile3, rm as rm3, writeFile } from "fs/promises";
+import { homedir as homedir5 } from "os";
+import { tmpdir as tmpdir3 } from "os";
+import { join as join6 } from "path";
 
 // ../../node_modules/@ai-sdk/gateway/node_modules/@ai-sdk/provider/dist/index.js
 var marker = "vercel.ai.error";
@@ -51171,9 +51531,9 @@ async function prepareVisionImage(pngBase64) {
   if (process.platform !== "darwin") {
     return { base64: pngBase64, mediaType: "image/png" };
   }
-  const dir = await mkdtemp2(join5(tmpdir2(), "yoqa-vision-"));
-  const inPath = join5(dir, "shot.png");
-  const outPath = join5(dir, "shot.jpg");
+  const dir = await mkdtemp3(join6(tmpdir3(), "yoqa-vision-"));
+  const inPath = join6(dir, "shot.png");
+  const outPath = join6(dir, "shot.jpg");
   try {
     await writeFile(inPath, new Uint8Array(bytes));
     const proc = Bun.spawn([
@@ -51194,7 +51554,7 @@ async function prepareVisionImage(pngBase64) {
     if (code !== 0) {
       return { base64: pngBase64, mediaType: "image/png" };
     }
-    const jpeg = await readFile2(outPath);
+    const jpeg = await readFile3(outPath);
     if (jpeg.byteLength === 0 || jpeg.byteLength >= bytes.byteLength) {
       return { base64: pngBase64, mediaType: "image/png" };
     }
@@ -51202,7 +51562,7 @@ async function prepareVisionImage(pngBase64) {
   } catch {
     return { base64: pngBase64, mediaType: "image/png" };
   } finally {
-    await rm2(dir, { recursive: true, force: true }).catch(() => {
+    await rm3(dir, { recursive: true, force: true }).catch(() => {
       return;
     });
   }
@@ -51389,8 +51749,8 @@ function openCodeAuthPaths() {
   const paths = [];
   const xdg = process.env.XDG_DATA_HOME?.trim();
   if (xdg)
-    paths.push(join5(xdg, "opencode", "auth.json"));
-  paths.push(join5(homedir4(), ".local", "share", "opencode", "auth.json"));
+    paths.push(join6(xdg, "opencode", "auth.json"));
+  paths.push(join6(homedir5(), ".local", "share", "opencode", "auth.json"));
   return paths;
 }
 function apiKeyFromOpenCodeAuthEntry(value) {
@@ -60599,13 +60959,13 @@ function createAnthropic(options = {}) {
 var anthropic = createAnthropic();
 
 // src/domains/providers/drivers/probe.ts
-import { constants } from "fs";
-import { access } from "fs/promises";
-import { homedir as homedir5 } from "os";
-import { isAbsolute, join as join6 } from "path";
+import { constants as constants2 } from "fs";
+import { access as access2 } from "fs/promises";
+import { homedir as homedir6 } from "os";
+import { isAbsolute, join as join7 } from "path";
 async function pathExists(path) {
   try {
-    await access(path, constants.F_OK);
+    await access2(path, constants2.F_OK);
     return true;
   } catch {
     return false;
@@ -60627,13 +60987,13 @@ async function which(binary) {
 `)[0]?.trim();
   return resolved || null;
 }
-function knownHomeBinCandidates(binaryName, home = homedir5()) {
+function knownHomeBinCandidates(binaryName, home = homedir6()) {
   return [
-    join6(home, ".opencode", "bin", binaryName),
-    join6(home, ".grok", "bin", binaryName),
-    join6(home, ".antigravity", "antigravity", "bin", binaryName),
-    join6(home, ".local", "bin", binaryName),
-    join6(home, ".bun", "bin", binaryName),
+    join7(home, ".opencode", "bin", binaryName),
+    join7(home, ".grok", "bin", binaryName),
+    join7(home, ".antigravity", "antigravity", "bin", binaryName),
+    join7(home, ".local", "bin", binaryName),
+    join7(home, ".bun", "bin", binaryName),
     `/opt/homebrew/bin/${binaryName}`,
     `/usr/local/bin/${binaryName}`
   ];
@@ -60898,9 +61258,9 @@ function resolveAgyModelId(raw, fallback = ANTIGRAVITY_DEFAULT_VISION_MODEL) {
 }
 
 // src/domains/providers/drivers/antigravity-vision.ts
-import { mkdtemp as mkdtemp3, rm as rm3, writeFile as writeFile2 } from "fs/promises";
-import { tmpdir as tmpdir3 } from "os";
-import { join as join7 } from "path";
+import { mkdtemp as mkdtemp4, rm as rm4, writeFile as writeFile2 } from "fs/promises";
+import { tmpdir as tmpdir4 } from "os";
+import { join as join8 } from "path";
 
 // ../../node_modules/@ai-sdk/google/node_modules/@ai-sdk/provider/dist/index.js
 var marker29 = "vercel.ai.error";
@@ -70375,8 +70735,8 @@ async function completeWithAgyCli(input, repairHint) {
   const image = input.image ?? await prepareVisionImage(input.imageBase64);
   const model = resolveAgyModelId(input.auth.defaultModel);
   const ext = image.mediaType === "image/jpeg" ? "jpg" : "png";
-  const dir = await mkdtemp3(join7(tmpdir3(), "yoqa-agy-"));
-  const shotPath = join7(dir, `shot.${ext}`);
+  const dir = await mkdtemp4(join8(tmpdir4(), "yoqa-agy-"));
+  const shotPath = join8(dir, `shot.${ext}`);
   try {
     await writeFile2(shotPath, new Uint8Array(Buffer.from(image.base64, "base64")));
     const userText = [
@@ -70416,7 +70776,7 @@ ${result.stderr}`.trim();
     }
     throw error40;
   } finally {
-    await rm3(dir, { recursive: true, force: true }).catch(() => {
+    await rm4(dir, { recursive: true, force: true }).catch(() => {
       return;
     });
   }
@@ -78884,9 +79244,9 @@ ${result.stderr}`.toLowerCase();
 };
 
 // src/domains/providers/drivers/cursor-vision.ts
-import { mkdtemp as mkdtemp4, rm as rm4, writeFile as writeFile3 } from "fs/promises";
-import { tmpdir as tmpdir4 } from "os";
-import { join as join8 } from "path";
+import { mkdtemp as mkdtemp5, rm as rm5, writeFile as writeFile3 } from "fs/promises";
+import { tmpdir as tmpdir5 } from "os";
+import { join as join9 } from "path";
 var CURSOR_DEFAULT_VISION_MODEL = "auto";
 var JSON_REPAIR_PROMPT3 = "Your previous reply was not valid JSON for this task. Reply again with ONLY one strict JSON object using double quotes for every key and string (no single quotes, no markdown, no prose).";
 function resolveCursorApiKey(auth) {
@@ -78899,8 +79259,8 @@ async function invokeCursorPrint(input) {
   }
   const model = input.auth.defaultModel?.trim() || CURSOR_DEFAULT_VISION_MODEL;
   const ext = input.mediaType === "image/jpeg" ? "jpg" : "png";
-  const dir = await mkdtemp4(join8(tmpdir4(), "yoqa-cursor-"));
-  const shotPath = join8(dir, `shot.${ext}`);
+  const dir = await mkdtemp5(join9(tmpdir5(), "yoqa-cursor-"));
+  const shotPath = join9(dir, `shot.${ext}`);
   const apiKey = resolveCursorApiKey(input.auth);
   try {
     await writeFile3(shotPath, new Uint8Array(Buffer.from(input.imageBase64, "base64")));
@@ -78937,7 +79297,7 @@ ${result.stderr}`.trim();
     }
     return result.stdout.trim() || combined;
   } finally {
-    await rm4(dir, { recursive: true, force: true }).catch(() => {
+    await rm5(dir, { recursive: true, force: true }).catch(() => {
       return;
     });
   }
@@ -99029,8 +99389,8 @@ var openaiDriver = {
 };
 
 // src/domains/providers/drivers/opencode-config.ts
-import { homedir as homedir6 } from "os";
-import { join as join9 } from "path";
+import { homedir as homedir7 } from "os";
+import { join as join10 } from "path";
 var OPENAI_COMPATIBLE_PACKAGES = new Set([
   "@ai-sdk/openai-compatible",
   "@ai-sdk/openai",
@@ -99058,8 +99418,8 @@ function openCodeConfigPaths() {
   const paths = [];
   const xdg = process.env.XDG_CONFIG_HOME?.trim();
   if (xdg)
-    paths.push(join9(xdg, "opencode", "opencode.json"));
-  paths.push(join9(homedir6(), ".config", "opencode", "opencode.json"));
+    paths.push(join10(xdg, "opencode", "opencode.json"));
+  paths.push(join10(homedir7(), ".config", "opencode", "opencode.json"));
   return paths;
 }
 function parseOpenCodeCompatibleProvider(config2, providerId) {
@@ -99880,6 +100240,7 @@ var agentDecisionSchema = exports_external.object({
     exports_external.literal("restart-app"),
     exports_external.literal("background-app"),
     exports_external.literal("open-url"),
+    exports_external.literal("key"),
     exports_external.literal("assert"),
     exports_external.literal("verify"),
     exports_external.literal("done"),
@@ -99909,6 +100270,8 @@ var agentDecisionSchema = exports_external.object({
   appId: exports_external.string().min(1).optional(),
   url: exports_external.string().min(1).optional(),
   seconds: exports_external.number().optional(),
+  key: keyNameSchema.optional(),
+  modifiers: exports_external.array(keyModifierSchema).optional(),
   assertion: exports_external.union([exports_external.literal("visible"), exports_external.literal("not-visible")]).optional(),
   timeoutMs: exports_external.number().optional(),
   reason: exports_external.string().min(1),
@@ -99937,6 +100300,9 @@ var agentDecisionSchema = exports_external.object({
   if (value.type === "open-url" && !value.url?.trim()) {
     ctx.addIssue({ code: exports_external.ZodIssueCode.custom, message: "open-url requires url" });
   }
+  if (value.type === "key" && !value.key) {
+    ctx.addIssue({ code: exports_external.ZodIssueCode.custom, message: "key requires key" });
+  }
   if (value.type === "assert" && !value.text?.trim()) {
     ctx.addIssue({ code: exports_external.ZodIssueCode.custom, message: "assert requires text" });
   }
@@ -100000,7 +100366,7 @@ function releaseCanvasPoint(decision, elements) {
   return point;
 }
 var SNAP_RADIUS = 100;
-var TAPPABLE_ROLE_RE = /button|link|cell|switch|checkbox|radio|tab|toggle|textfield|searchfield|segment|menuitem|stepper|slider|picker/i;
+var TAPPABLE_ROLE_RE = /button|link|cell|switch|checkbox|radio|tab|toggle|textfield|searchfield|segment|menuitem|stepper|slider|picker|textbox|searchbox|combobox|option/i;
 function isTappableElement(element) {
   if (isFullBleedElement(element))
     return false;
@@ -100223,6 +100589,12 @@ function decisionToActionRequest(decision, options = {}) {
       };
     case "open-url":
       return decision.url ? { kind: "open-url", url: decision.url } : null;
+    case "key":
+      return decision.key ? {
+        kind: "key",
+        key: decision.key,
+        ...decision.modifiers?.length ? { modifiers: decision.modifiers } : {}
+      } : null;
     default:
       return null;
   }
@@ -100315,6 +100687,8 @@ var APP_LIFECYCLE_SHAPES = `{"type":"activate-app","appId":"com.example.app","re
 {"type":"restart-app","appId":"com.example.app","reason":"...","thoughts":"..."}
 {"type":"background-app","seconds":3,"reason":"...","thoughts":"..."}
 {"type":"open-url","url":"https://example.com","reason":"...","thoughts":"..."}
+{"type":"key","key":"Enter","reason":"...","thoughts":"..."}
+{"type":"key","key":"Tab","modifiers":["Shift"],"reason":"...","thoughts":"..."}
 {"type":"assert","assertion":"visible|not-visible","text":"...","reason":"...","thoughts":"..."}
 {"type":"wait","ms":500-3000,"reason":"...","thoughts":"..."}
 {"type":"verify","reason":"...","thoughts":"..."}
@@ -100332,6 +100706,7 @@ var SWIPE_GUIDANCE = `Swipe direction is the FINGER movement (same as Inspector)
 - "left" / "right": horizontal paging
 When the case says "scroll up", emit direction "down". When it says "scroll down" or "to the bottom", emit direction "up". Never tap to scroll. Never emit wait as a stand-in for scrolling.`;
 var SHARED_RULES = `- activate-app / terminate-app / restart-app / open-url / background-app match yoqa action. Omit appId to use the catalog app id provided in the user message.
+- key presses one named key: ${KEY_NAMES.join("|")}, with optional modifiers ${KEY_MODIFIERS.join("|")}. Use it to submit a form (Enter), move focus (Tab), close a dialog or menu (Escape), or move through a list or combobox (arrows). If the device cannot press that key, the error says so; choose another action.
 - To scroll a list or page, emit swipe \u2014 never a tap in the middle of the screen as a stand-in for scrolling.
 - "Scroll until you cannot scroll anymore" / "to the bottom": keep emitting swipe (direction "up") until a later screenshot shows the same content. Then verify. Unchanged screens after taps do not count \u2014 taps do not scroll.
 - You are given ONE current instruction. Complete only that instruction, then return verify or done. Later instructions are hidden on purpose \u2014 do not invent, skip ahead, or combine them. Earlier finished instructions may be omitted \u2014 do not reconstruct them.
@@ -100453,6 +100828,9 @@ function formatRecentActions(actions) {
     if (action.type === "open-url") {
       return `${n}. open-url ${action.url ?? ""} \u2014 ${action.reason ?? ""}`;
     }
+    if (action.type === "key") {
+      return `${n}. key ${formatKeyChord(action.key ?? "?", action.modifiers)} \u2014 ${action.reason ?? ""}`;
+    }
     if (action.type === "wait") {
       return `${n}. wait ${action.ms ?? "?"}ms \u2014 ${action.reason ?? ""}`;
     }
@@ -100745,6 +101123,15 @@ function buildScriptFromDecisions(decisions, sourceRunId) {
         url: decision.url,
         reason: decision.reason
       });
+    } else if (decision.type === "key") {
+      if (!decision.key)
+        continue;
+      actions.push({
+        type: "key",
+        key: decision.key,
+        ...decision.modifiers?.length ? { modifiers: decision.modifiers } : {},
+        reason: decision.reason
+      });
     } else if (decision.type === "assert") {
       if (!decision.text?.trim())
         continue;
@@ -100807,6 +101194,7 @@ function mapApp(row) {
     iosBundleId: row.iosBundleId,
     iosAppStoreId: row.iosAppStoreId,
     androidApplicationId: row.androidApplicationId,
+    webUrl: row.webUrl,
     capabilities: [],
     createdAt: row.createdAt,
     updatedAt: row.updatedAt
@@ -100981,6 +101369,7 @@ async function createApp(input) {
   if (!name30) {
     throw new CatalogValidationError("Application name is required");
   }
+  const webUrl = parseWebUrl(input.webUrl ?? "");
   const db = getCatalogDb();
   const now = Date.now();
   const id = newId2("app");
@@ -100994,6 +101383,7 @@ async function createApp(input) {
     iosBundleId: "",
     iosAppStoreId: "",
     androidApplicationId: "",
+    webUrl,
     appiumCaps: "[]",
     createdAt: now,
     updatedAt: now
@@ -101004,6 +101394,16 @@ async function createApp(input) {
   }
   return created;
 }
+function parseWebUrl(raw) {
+  const webUrl = raw.trim();
+  if (!webUrl)
+    return "";
+  const protocol = URL.canParse(webUrl) ? new URL(webUrl).protocol : null;
+  if (protocol !== "http:" && protocol !== "https:") {
+    throw new CatalogValidationError(`Web URL must be an http or https URL, not "${webUrl}"`);
+  }
+  return webUrl;
+}
 var MAX_APP_KNOWLEDGE_CHARS2 = 2048;
 async function updateApp(appId, input) {
   const db = getCatalogDb();
@@ -101018,6 +101418,7 @@ async function updateApp(appId, input) {
   if (input.knowledge !== undefined && input.knowledge.length > MAX_APP_KNOWLEDGE_CHARS2) {
     throw new CatalogValidationError(`App knowledge must be at most ${MAX_APP_KNOWLEDGE_CHARS2} characters`);
   }
+  const webUrl = input.webUrl !== undefined ? parseWebUrl(input.webUrl) : existing.webUrl;
   const prefix = input.prefix !== undefined ? await allocatePrefix(input.prefix.trim() || name30, appId) : existing.prefix || await allocatePrefix(name30, appId);
   await db.update(apps).set({
     name: name30,
@@ -101027,6 +101428,7 @@ async function updateApp(appId, input) {
     iosBundleId: input.iosBundleId ?? existing.iosBundleId,
     iosAppStoreId: input.iosAppStoreId ?? existing.iosAppStoreId,
     androidApplicationId: input.androidApplicationId ?? existing.androidApplicationId,
+    webUrl,
     updatedAt: Date.now()
   }).where(eq(apps.id, appId));
   const updated = await getApp(appId);
@@ -101279,7 +101681,7 @@ function abortAllMjpegProxies() {
 
 // src/domains/devices/android-devtools.ts
 import { existsSync as existsSync2 } from "fs";
-import { join as join10 } from "path";
+import { join as join11 } from "path";
 function escapeAttr(value) {
   return value.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;").replaceAll('"', "&quot;");
 }
@@ -101307,13 +101709,13 @@ var DEVTOOLS_PACKAGE = "yoqa.android.devtools";
 var DEVTOOLS_INSTRUMENTATION = `${DEVTOOLS_PACKAGE}/.DevtoolsInstrumentation`;
 var DEVTOOLS_VERSION_CODE = 2;
 var DEVTOOLS_DEVICE_PORT = 7421;
-var READY_TIMEOUT_MS = 1e4;
+var READY_TIMEOUT_MS2 = 1e4;
 var TREE_TIMEOUT_MS = 5000;
 function resolveDevtoolsApk() {
   const fromEnv = process.env.YOQA_ANDROID_DEVTOOLS_APK?.trim();
   if (fromEnv)
     return fromEnv;
-  const built = join10(import.meta.dir, "../../../../../native/android-devtools/app/build/outputs/apk/debug/app-debug.apk");
+  const built = join11(import.meta.dir, "../../../../../native/android-devtools/app/build/outputs/apk/debug/app-debug.apk");
   return existsSync2(built) ? built : null;
 }
 async function adbOk(adb, args, label) {
@@ -101422,7 +101824,7 @@ async function startAndroidDevtools(context, deps = {}) {
     });
   };
   try {
-    await waitUntilReady(base, instrument, deps.readyTimeoutMs ?? READY_TIMEOUT_MS);
+    await waitUntilReady(base, instrument, deps.readyTimeoutMs ?? READY_TIMEOUT_MS2);
   } catch (error40) {
     await stop();
     throw error40;
@@ -101435,9 +101837,38 @@ async function startAndroidDevtools(context, deps = {}) {
 
 // src/domains/devices/android-direct-lane.ts
 import { mkdir } from "fs/promises";
-import { dirname as dirname2, join as join12 } from "path";
+import { dirname as dirname2, join as join13 } from "path";
 
 // src/domains/devices/adb-input.ts
+var ANDROID_KEYCODES = {
+  Enter: 66,
+  Tab: 61,
+  Escape: 111,
+  Backspace: 67,
+  Delete: 112,
+  ArrowUp: 19,
+  ArrowDown: 20,
+  ArrowLeft: 21,
+  ArrowRight: 22,
+  Home: 122,
+  End: 123,
+  PageUp: 92,
+  PageDown: 93,
+  Space: 62
+};
+var ANDROID_MODIFIER_KEYCODES = {
+  Shift: 59,
+  Control: 113,
+  Alt: 57,
+  Meta: 117
+};
+function adbKeyArgs(key, modifiers = []) {
+  const code = String(ANDROID_KEYCODES[key]);
+  if (modifiers.length === 0)
+    return ["input", "keyevent", code];
+  const held = modifiers.map((modifier) => String(ANDROID_MODIFIER_KEYCODES[modifier]));
+  return ["input", "keycombination", ...held, code];
+}
 function parseWmSize(stdout) {
   const override = stdout.match(/Override size:\s*(\d+)x(\d+)/i);
   const physical = stdout.match(/Physical size:\s*(\d+)x(\d+)/i);
@@ -101546,6 +101977,21 @@ function reportLaneFallback(session, options, warning) {
   session.laneWarning = joinLaneWarnings(session.laneWarning, warning);
   options.onLaneWarning?.(warning);
 }
+
+class UnsupportedKeyError extends Error {
+  constructor(message) {
+    super(message);
+    this.name = "UnsupportedKeyError";
+  }
+}
+function assertKeySupported(support, device, key, modifiers = []) {
+  if (!support.keys.includes(key)) {
+    throw new UnsupportedKeyError(`The ${key} key is not available ${device}; it can press ${support.keys.join(", ")}`);
+  }
+  if (modifiers.length > 0 && !support.modifiers) {
+    throw new UnsupportedKeyError(`Modifier keys (${modifiers.join(", ")}) are not available ${device}; press ${key} without them`);
+  }
+}
 var DEAD_SESSION_RE = /session does not exist|invalid session id|no such session|terminated or not started|session is either terminated/i;
 
 class DeadSessionError extends Error {
@@ -101555,6 +102001,13 @@ class DeadSessionError extends Error {
   }
 }
 
+class ActionUnsupportedError extends Error {
+  constructor(message) {
+    super(message);
+    this.name = "ActionUnsupportedError";
+  }
+}
+
 class DeviceUnreachableError extends Error {
   unreachableMs;
   graceMs;
@@ -101593,7 +102046,7 @@ function createFrameLoop(capture, options = {}) {
   const now = () => performance.now();
   let latest = null;
   let fatal = null;
-  let running = false;
+  let running2 = false;
   let kicked = false;
   let lastRead = 0;
   let waiters = [];
@@ -101632,12 +102085,12 @@ function createFrameLoop(capture, options = {}) {
     }
   };
   const run = async () => {
-    running = true;
+    running2 = true;
     while (!fatal && (waiters.length > 0 || now() - lastRead < idleMs)) {
       if (!await captureOnce(true) && !fatal)
         await Bun.sleep(RETRY_AFTER_ERROR_MS);
     }
-    running = false;
+    running2 = false;
   };
   return {
     read: (after = 0) => {
@@ -101649,12 +102102,12 @@ function createFrameLoop(capture, options = {}) {
       const pending = new Promise((resolve7, reject) => {
         waiters.push({ after, resolve: resolve7, reject });
       });
-      if (!running)
+      if (!running2)
         run();
       return pending;
     },
     kick: () => {
-      if (fatal || !running || kicked)
+      if (fatal || !running2 || kicked)
         return;
       kicked = true;
       captureOnce(false).finally(() => {
@@ -101705,9 +102158,9 @@ async function exitsWithin(proc, ms) {
 
 // src/domains/devices/screenshot-retention.ts
 import { readdir, stat, unlink } from "fs/promises";
-import { homedir as homedir7 } from "os";
-import { join as join11 } from "path";
-var SCREENSHOT_DIR = join11(homedir7(), ".yoqa", "runs", "screenshots");
+import { homedir as homedir8 } from "os";
+import { join as join12 } from "path";
+var SCREENSHOT_DIR = join12(homedir8(), ".yoqa", "runs", "screenshots");
 var SHOT_FILE_RE = /^shot_\d+_[0-9a-f-]+\.png$/i;
 var DEFAULT_RETENTION_DAYS = 7;
 var DAY_MS = 24 * 60 * 60 * 1000;
@@ -101735,7 +102188,7 @@ async function pruneOldRunScreenshots(options = {}) {
     const names = (await readdir(dir)).filter((name30) => SHOT_FILE_RE.test(name30));
     const entries = [];
     for (const name30 of names) {
-      const info = await stat(join11(dir, name30));
+      const info = await stat(join12(dir, name30));
       entries.push({ name: name30, mtimeMs: info.mtimeMs });
     }
     let removed = 0;
@@ -101744,7 +102197,7 @@ async function pruneOldRunScreenshots(options = {}) {
       now: options.now ?? Date.now()
     })) {
       try {
-        await unlink(join11(dir, name30));
+        await unlink(join12(dir, name30));
         removed += 1;
       } catch {}
     }
@@ -101763,6 +102216,7 @@ async function readRemotePid(stdout) {
     throw new Error(`screenrecord: could not read its pid (${pid || "empty"})`);
   return pid;
 }
+var ANDROID_KEY_SUPPORT = { keys: KEY_NAMES, modifiers: true };
 var ADB_LOST_RE = /device '.*' not found|device offline|device not found|no devices\/emulators found/i;
 function adbLostDevice(result) {
   return result.exitCode === 127 || result.exitCode !== 0 && ADB_LOST_RE.test(result.stderr);
@@ -101881,7 +102335,7 @@ async function createAndroidDirectSession(options, deps = {}) {
   const screenshot = async () => {
     await mkdir(SCREENSHOT_DIR, { recursive: true });
     const frame = await captureFrame();
-    const path = join12(SCREENSHOT_DIR, `shot_${Date.now()}_${crypto.randomUUID()}.png`);
+    const path = join13(SCREENSHOT_DIR, `shot_${Date.now()}_${crypto.randomUUID()}.png`);
     await Bun.write(path, Uint8Array.from(Buffer.from(frame.base64, "base64")));
     return { path, base64: frame.base64 };
   };
@@ -101904,9 +102358,9 @@ async function createAndroidDirectSession(options, deps = {}) {
     await adb(["-s", serial, "shell", "am", "force-stop", DEVTOOLS_PACKAGE]);
   }
   const stopDevtools = async () => {
-    const running = devtools;
+    const running2 = devtools;
     devtools = null;
-    await running?.stop().catch(() => {
+    await running2?.stop().catch(() => {
       return;
     });
   };
@@ -101980,6 +102434,12 @@ async function createAndroidDirectSession(options, deps = {}) {
       }
     });
   };
+  const key = async (name30, modifiers = []) => {
+    assertKeySupported(ANDROID_KEY_SUPPORT, "on Android", name30, modifiers);
+    await lock.withLock(async () => {
+      await shell2(adbKeyArgs(name30, modifiers), "input key");
+    });
+  };
   const activateApp = async (appId) => {
     await lock.withLock(async () => {
       lastAppId = appId;
@@ -102060,6 +102520,8 @@ async function createAndroidDirectSession(options, deps = {}) {
     swipe,
     drag: (x1, y1, x2, y2, durationMs = 800) => swipe(x1, y1, x2, y2, durationMs),
     type,
+    keySupport: ANDROID_KEY_SUPPORT,
+    key,
     activateApp,
     setTargetApp: (appId) => {
       lastAppId = appId;
@@ -102099,7 +102561,7 @@ async function createAndroidDirectSession(options, deps = {}) {
 
 // src/domains/devices/ios-device-lane.ts
 import { mkdir as mkdir5 } from "fs/promises";
-import { join as join18 } from "path";
+import { join as join19 } from "path";
 
 // src/domains/devices/error-chain.ts
 var MAX_LINKS = 8;
@@ -102128,9 +102590,9 @@ function errorChain(error40) {
 }
 
 // src/domains/devices/frame-recorder.ts
-import { mkdir as mkdir2, mkdtemp as mkdtemp5, rm as rm5 } from "fs/promises";
-import { tmpdir as tmpdir5 } from "os";
-import { dirname as dirname3, join as join13 } from "path";
+import { mkdir as mkdir2, mkdtemp as mkdtemp6, rm as rm6 } from "fs/promises";
+import { tmpdir as tmpdir6 } from "os";
+import { dirname as dirname3, join as join14 } from "path";
 var LAST_FRAME_HOLD_S = 0.5;
 async function encodeWithFfmpeg(ffmpeg, list, out) {
   const proc = Bun.spawn([
@@ -102178,36 +102640,36 @@ async function recordFrames(source, path, deps = realDeps) {
   if (!ffmpeg)
     throw new Error("ffmpeg not found on PATH");
   await mkdir2(dirname3(path), { recursive: true });
-  const dir = await mkdtemp5(join13(tmpdir5(), "yoqa-frames-"));
+  const dir = await mkdtemp6(join14(tmpdir6(), "yoqa-frames-"));
   try {
     await source.start?.();
   } catch (error40) {
-    await rm5(dir, { recursive: true, force: true }).catch(() => {
+    await rm6(dir, { recursive: true, force: true }).catch(() => {
       return;
     });
     throw error40;
   }
   const frames = [];
-  let running = true;
+  let running2 = true;
   const pullOnce = async () => {
     try {
       for (const frame of await source.pull()) {
-        const file2 = join13(dir, `${String(frames.length).padStart(6, "0")}.${frame.ext}`);
+        const file2 = join14(dir, `${String(frames.length).padStart(6, "0")}.${frame.ext}`);
         await Bun.write(file2, frame.bytes);
         frames.push({ file: file2, at: frame.at });
       }
     } catch {}
   };
   const loop = (async () => {
-    while (running) {
+    while (running2) {
       await pullOnce();
-      if (running)
+      if (running2)
         await Bun.sleep(source.intervalMs);
     }
   })();
   return {
     stop: async () => {
-      running = false;
+      running2 = false;
       await loop;
       try {
         await pullOnce();
@@ -102223,13 +102685,13 @@ async function recordFrames(source, path, deps = realDeps) {
           lines.push(`file '${frame.file}'`, `duration ${Math.max(seconds, 0.001).toFixed(3)}`);
         }
         lines.push(`file '${frames[frames.length - 1]?.file}'`);
-        const list = join13(dir, "frames.txt");
+        const list = join14(dir, "frames.txt");
         await Bun.write(list, `${lines.join(`
 `)}
 `);
         await deps.encode(ffmpeg, list, path);
       } finally {
-        await rm5(dir, { recursive: true, force: true }).catch(() => {
+        await rm6(dir, { recursive: true, force: true }).catch(() => {
           return;
         });
       }
@@ -102565,16 +103027,16 @@ async function startPhonePreview(send) {
 }
 
 // src/domains/devices/ios-direct-lane.ts
-import { mkdir as mkdir3, readFile as readFile3 } from "fs/promises";
-import { tmpdir as tmpdir6 } from "os";
-import { dirname as dirname4, join as join16 } from "path";
+import { mkdir as mkdir3, readFile as readFile4 } from "fs/promises";
+import { tmpdir as tmpdir7 } from "os";
+import { dirname as dirname4, join as join17 } from "path";
 
 // src/domains/devices/idb-companion.ts
 import { existsSync as existsSync3 } from "fs";
-import { homedir as homedir8 } from "os";
-import { join as join14 } from "path";
-var IDB_COMPANION_HOME = join14(homedir8(), ".yoqa", "idb", "idb_companion");
-var IDB_CLIENT_HOME = join14(homedir8(), ".yoqa", "idb", "venv", "bin", "idb");
+import { homedir as homedir9 } from "os";
+import { join as join15 } from "path";
+var IDB_COMPANION_HOME = join15(homedir9(), ".yoqa", "idb", "idb_companion");
+var IDB_CLIENT_HOME = join15(homedir9(), ".yoqa", "idb", "venv", "bin", "idb");
 var MISSING_IDB_MESSAGE = "idb_companion not found. Install the official facebook/idb v1.6.5 macOS binary from GitHub releases to ~/.yoqa/idb/idb_companion (or set YOQA_IDB_COMPANION). Do not use `brew trust facebook/fb`.";
 function resolveIdbCompanionPath(env = process.env, exists2 = existsSync3, which2 = (name30) => Bun.which(name30)) {
   const fromEnv = env.YOQA_IDB_COMPANION?.trim();
@@ -102756,9 +103218,83 @@ function cleanIdbCompleteSource(raw, window2) {
   }
   return { elements, window: window2 };
 }
+var WEB_STRUCTURAL_ROLES = new Set(["RootWebArea", "InlineTextBox", "LineBreak"]);
+var WEB_CONTROL_ROLES = new Set([
+  "button",
+  "link",
+  "checkbox",
+  "radio",
+  "switch",
+  "tab",
+  "menuitem",
+  "menuitemcheckbox",
+  "menuitemradio",
+  "option",
+  "textbox",
+  "searchbox",
+  "combobox",
+  "slider",
+  "spinbutton"
+]);
+var WEB_TEXT_ROLES = new Set(["StaticText"]);
+var GENERATED_DOM_ID = /^(:r[0-9a-z]+:|\u00ABr[0-9a-z]+\u00BB)$/i;
+function axText(value) {
+  return typeof value?.value === "string" ? value.value.replace(/\s+/g, " ").trim() : "";
+}
+function webIdOf(node) {
+  const testId = node.testId?.trim();
+  if (testId)
+    return testId;
+  const domId = node.domId?.trim() ?? "";
+  return GENERATED_DOM_ID.test(domId) ? "" : domId;
+}
+function cleanWebAxSource(source, window2) {
+  const byId = new Map(source.axTree.map((node) => [node.nodeId, node]));
+  const namedParentLabel = (node) => {
+    let parent = node.parentId ? byId.get(node.parentId) : undefined;
+    while (parent) {
+      const label = axText(parent.name);
+      if (label && !parent.ignored)
+        return label;
+      parent = parent.parentId ? byId.get(parent.parentId) : undefined;
+    }
+    return "";
+  };
+  const elements = [];
+  for (const node of source.axTree) {
+    if (node.ignored || !node.bounds)
+      continue;
+    if (node.bounds.width <= 0 || node.bounds.height <= 0)
+      continue;
+    const type = axText(node.role);
+    if (WEB_STRUCTURAL_ROLES.has(type))
+      continue;
+    const label = axText(node.name) || axText(node.value);
+    if (!label && !WEB_CONTROL_ROLES.has(type))
+      continue;
+    if (WEB_TEXT_ROLES.has(type) && namedParentLabel(node).includes(label))
+      continue;
+    const id = webIdOf(node);
+    const disabled = node.properties?.some((property) => property.name === "disabled" && property.value?.value === true);
+    pushNormalized(elements, window2, {
+      type,
+      label,
+      id: id || undefined,
+      rect: node.bounds,
+      enabled: !disabled
+    });
+  }
+  return { elements, window: window2 };
+}
+function isWebAxSource(parsed) {
+  return typeof parsed === "object" && parsed !== null && Array.isArray(parsed.axTree);
+}
 function cleanPageSource(xml, window2) {
   const trimmed = xml.trim();
   if (trimmed.startsWith("{") || trimmed.startsWith("[")) {
+    const parsed = JSON.parse(trimmed);
+    if (isWebAxSource(parsed))
+      return cleanWebAxSource(parsed, window2);
     return cleanIdbCompleteSource(trimmed, window2);
   }
   const elements = [];
@@ -102802,7 +103338,7 @@ function cleanPageSource(xml, window2) {
 
 // src/domains/devices/yoqa-sim.ts
 import { existsSync as existsSync4 } from "fs";
-import { join as join15 } from "path";
+import { join as join16 } from "path";
 
 class YoqaSimUnreachableError extends Error {
   constructor(message) {
@@ -102813,19 +103349,19 @@ class YoqaSimUnreachableError extends Error {
 function spawnProcess(command) {
   return Bun.spawn(command, { stdin: "pipe", stdout: "pipe", stderr: "pipe" });
 }
-var READY_TIMEOUT_MS2 = 1e4;
+var READY_TIMEOUT_MS3 = 1e4;
 var STREAM_READY_TIMEOUT_MS = 500;
 var REQUEST_TIMEOUT_MS = 1e4;
-var STOP_GRACE_MS = 2000;
+var STOP_GRACE_MS2 = 2000;
 var API_READY_RE = /^api_ready (http:\/\/127\.0\.0\.1:\d+)\s*$/;
 var STREAM_READY_RE = /^stream_ready (http:\/\/127\.0\.0\.1:\d+\/\S+)\s*$/;
 function resolveYoqaSimBin() {
   const fromEnv = process.env.YOQA_SIM_BIN?.trim();
   if (fromEnv)
     return fromEnv;
-  const root = join15(import.meta.dir, "../../../../../native/yoqa-sim/.build");
+  const root = join16(import.meta.dir, "../../../../../native/yoqa-sim/.build");
   for (const config2 of ["release", "debug"]) {
-    const built = join15(root, config2, "yoqa-sim");
+    const built = join16(root, config2, "yoqa-sim");
     if (existsSync4(built))
       return built;
   }
@@ -102885,12 +103421,12 @@ async function spawnYoqaSim(udid, options) {
     proc.kill("SIGTERM");
     const exited = await Promise.race([
       proc.exited.then(() => true),
-      Bun.sleep(STOP_GRACE_MS).then(() => false)
+      Bun.sleep(STOP_GRACE_MS2).then(() => false)
     ]);
     if (!exited)
       proc.kill("SIGKILL");
   };
-  const timeoutMs = options.readyTimeoutMs ?? READY_TIMEOUT_MS2;
+  const timeoutMs = options.readyTimeoutMs ?? READY_TIMEOUT_MS3;
   let timer;
   const announced = await Promise.race([
     readAnnouncements(proc.stdout, options.streamReadyTimeoutMs ?? STREAM_READY_TIMEOUT_MS, () => clearTimeout(timer)),
@@ -102899,7 +103435,7 @@ async function spawnYoqaSim(udid, options) {
     })
   ]).finally(() => clearTimeout(timer));
   const stderrTail = async () => {
-    const text3 = await Promise.race([stderr, Bun.sleep(STOP_GRACE_MS).then(() => "")]);
+    const text3 = await Promise.race([stderr, Bun.sleep(STOP_GRACE_MS2).then(() => "")]);
     return text3.trim().split(`
 `).slice(-3).join(" ");
   };
@@ -102969,6 +103505,23 @@ async function spawnYoqaSim(udid, options) {
 var IOS_ACCEPT_LABELS = ["Allow While Using App", "Allow Once", "Allow", "OK"];
 var IOS_DISMISS_LABELS = ["Don't Allow", "Don\u2019t Allow", "Don't allow"];
 var graphemes = new Intl.Segmenter(undefined, { granularity: "grapheme" });
+var IOS_HID_KEYCODES = {
+  Enter: 40,
+  Escape: 41,
+  Backspace: 42,
+  Tab: 43,
+  Space: 44,
+  Home: 74,
+  PageUp: 75,
+  Delete: 76,
+  End: 77,
+  PageDown: 78,
+  ArrowRight: 79,
+  ArrowLeft: 80,
+  ArrowDown: 81,
+  ArrowUp: 82
+};
+var IOS_SIMULATOR_KEY_SUPPORT = { keys: KEY_NAMES, modifiers: false };
 var IDB_LOST_RE = /StatusCode\.UNAVAILABLE|failed to connect|Connection refused|companion .*(?:not running|terminated)|(?:device|simulator|target) .*not found|not booted/i;
 function idbLostDevice(result) {
   return result.exitCode === 127 || result.exitCode !== 0 && IDB_LOST_RE.test(`${result.stderr}
@@ -103061,7 +103614,7 @@ async function recordViaSimctl(udid, path) {
   };
 }
 async function captureViaSimctl(udid) {
-  const dest = join16(tmpdir6(), `yoqa-simctl-${crypto.randomUUID()}.png`);
+  const dest = join17(tmpdir7(), `yoqa-simctl-${crypto.randomUUID()}.png`);
   const proc = Bun.spawn(["xcrun", "simctl", "io", udid, "screenshot", dest], {
     stdout: "pipe",
     stderr: "pipe"
@@ -103070,7 +103623,7 @@ async function captureViaSimctl(udid) {
   if (exitCode !== 0) {
     throw new Error(`simctl screenshot: ${stderr.trim() || `exit ${exitCode}`}`);
   }
-  return new Uint8Array(await readFile3(dest));
+  return new Uint8Array(await readFile4(dest));
 }
 async function createIosDirectSession(options, deps = {}) {
   if (options.platform !== "ios") {
@@ -103108,17 +103661,17 @@ async function createIosDirectSession(options, deps = {}) {
     return yoqaSim;
   };
   const viaYoqaSim = async (use, retryable = false) => {
-    const running = await startHelpers();
-    if (!running)
+    const running2 = await startHelpers();
+    if (!running2)
       return null;
     try {
-      return { value: await use(running) };
+      return { value: await use(running2) };
     } catch (error40) {
       if (!retryable && !(error40 instanceof YoqaSimUnreachableError))
         throw error40;
       yoqaSimFailed(error40);
       yoqaSim = Promise.resolve(null);
-      await running.stop().catch(() => {
+      await running2.stop().catch(() => {
         return;
       });
       return null;
@@ -103144,11 +103697,11 @@ async function createIosDirectSession(options, deps = {}) {
     return lock.withLock(fn);
   };
   const captureViaIdb = async () => {
-    const dest = join16(tmpdir6(), `yoqa-idb-${crypto.randomUUID()}.png`);
+    const dest = join17(tmpdir7(), `yoqa-idb-${crypto.randomUUID()}.png`);
     let bytes;
     try {
       const result = await run(["screenshot", dest, "--udid", udid], "idb screenshot");
-      bytes = result.stdoutBytes && result.stdoutBytes.byteLength > 8 ? result.stdoutBytes : new Uint8Array(await readFile3(dest));
+      bytes = result.stdoutBytes && result.stdoutBytes.byteLength > 8 ? result.stdoutBytes : new Uint8Array(await readFile4(dest));
       if (bytes.byteLength === 0)
         throw new Error("idb screenshot returned an empty frame");
     } catch (error40) {
@@ -103161,8 +103714,8 @@ async function createIosDirectSession(options, deps = {}) {
     return bytes;
   };
   const captureFrame = async () => {
-    const fromYoqaSim = await viaYoqaSim(async (running) => {
-      const frame = await running.frame();
+    const fromYoqaSim = await viaYoqaSim(async (running2) => {
+      const frame = await running2.frame();
       if (frame.bytes.byteLength === 0)
         throw new Error("empty frame");
       return frame;
@@ -103175,7 +103728,7 @@ async function createIosDirectSession(options, deps = {}) {
   const screenshot = async () => {
     await mkdir3(SCREENSHOT_DIR, { recursive: true });
     const frame = await captureFrame();
-    const path = join16(SCREENSHOT_DIR, `shot_${Date.now()}_${crypto.randomUUID()}.png`);
+    const path = join17(SCREENSHOT_DIR, `shot_${Date.now()}_${crypto.randomUUID()}.png`);
     await Bun.write(path, Uint8Array.from(Buffer.from(frame.base64, "base64")));
     return { path, base64: frame.base64 };
   };
@@ -103203,7 +103756,7 @@ async function createIosDirectSession(options, deps = {}) {
   const treeViaYoqaAx = async () => {
     if (!await yoqaAx)
       return null;
-    const hash = (await viaYoqaSim((running) => running.frame(), true))?.value.hash;
+    const hash = (await viaYoqaSim((running2) => running2.frame(), true))?.value.hash;
     if (hash && cachedTree?.hash === hash)
       return cachedTree.source;
     const read2 = await viaYoqaAx(async (ax) => {
@@ -103231,14 +103784,14 @@ async function createIosDirectSession(options, deps = {}) {
     await run(["ui", "tap", String(x), String(y), "--udid", udid, "--api", "hid"], "idb ui tap");
   };
   const tapNorm = async (xNorm, yNorm, tapOptions) => {
-    const sent = await viaYoqaSim((running) => running.tap(fraction(xNorm), fraction(yNorm), tapOptions?.durationMs));
+    const sent = await viaYoqaSim((running2) => running2.tap(fraction(xNorm), fraction(yNorm), tapOptions?.durationMs));
     if (sent)
       return;
     const size = await getWindowSize();
     await tapPx(toPx(xNorm, size.width), toPx(yNorm, size.height));
   };
   const swipeNorm = async (x1, y1, x2, y2, durationMs) => {
-    const sent = await viaYoqaSim((running) => running.swipe({ x: fraction(x1), y: fraction(y1) }, { x: fraction(x2), y: fraction(y2) }, durationMs));
+    const sent = await viaYoqaSim((running2) => running2.swipe({ x: fraction(x1), y: fraction(y1) }, { x: fraction(x2), y: fraction(y2) }, durationMs));
     if (sent)
       return;
     const size = await getWindowSize();
@@ -103266,6 +103819,12 @@ async function createIosDirectSession(options, deps = {}) {
       }
     });
   };
+  const key = async (name30, modifiers = []) => {
+    assertKeySupported(IOS_SIMULATOR_KEY_SUPPORT, "on an iOS simulator", name30, modifiers);
+    await withActionLock(async () => {
+      await run(["ui", "key", String(IOS_HID_KEYCODES[name30]), "--udid", udid], "idb ui key");
+    });
+  };
   const activateApp = async (appId) => {
     await withActionLock(async () => {
       lastAppId = appId;
@@ -103279,7 +103838,7 @@ async function createIosDirectSession(options, deps = {}) {
   };
   const backgroundApp = async (seconds = 3) => {
     await withActionLock(async () => {
-      const pressed = await viaYoqaSim((running) => running.key("home"));
+      const pressed = await viaYoqaSim((running2) => running2.key("home"));
       if (!pressed)
         await run(["ui", "button", "HOME", "--udid", udid], "idb HOME");
       await Bun.sleep(Math.max(0, seconds) * 1000);
@@ -103314,10 +103873,10 @@ async function createIosDirectSession(options, deps = {}) {
     quit: async () => {
       quitting = true;
       session.stream = null;
-      const [running, ax] = await Promise.all([yoqaSim, yoqaAx]);
+      const [running2, ax] = await Promise.all([yoqaSim, yoqaAx]);
       yoqaSim = null;
       yoqaAx = null;
-      await Promise.all([running?.stop(), ax?.stop()]);
+      await Promise.all([running2?.stop(), ax?.stop()]);
     },
     startRecording: (path) => recordViaSimctl(udid, path),
     captureFrame,
@@ -103328,6 +103887,8 @@ async function createIosDirectSession(options, deps = {}) {
     swipe,
     drag: (x1, y1, x2, y2, durationMs = 800) => swipe(x1, y1, x2, y2, durationMs),
     type,
+    keySupport: IOS_SIMULATOR_KEY_SUPPORT,
+    key,
     activateApp,
     setTargetApp: (appId) => {
       lastAppId = appId;
@@ -103387,10 +103948,10 @@ function yoqaAxTreeToSource(tree, window2) {
   }));
   return JSON.stringify(tree.degraded ? { elements, degraded: true } : { elements });
 }
-function liveStream(running) {
-  if (!running?.streamUrl)
+function liveStream(running2) {
+  if (!running2?.streamUrl)
     return null;
-  const { streamUrl } = running;
+  const { streamUrl } = running2;
   return { ready: true, port: Number(new URL(streamUrl).port), upstreamUrl: streamUrl };
 }
 
@@ -103615,10 +104176,10 @@ async function connectUsbmux(udid, port, socketPath = USBMUXD_SOCKET) {
 
 // src/domains/devices/yoqa-runner.ts
 import { X509Certificate, createHash } from "crypto";
-import { existsSync as existsSync5 } from "fs";
-import { copyFile, cp, mkdir as mkdir4, readFile as readFile4, readdir as readdir2, rename, rm as rm6, writeFile as writeFile4 } from "fs/promises";
-import { homedir as homedir9 } from "os";
-import { dirname as dirname5, join as join17, relative } from "path";
+import { existsSync as existsSync5, mkdirSync as mkdirSync2, readFileSync, renameSync, rmSync } from "fs";
+import { copyFile, cp, mkdir as mkdir4, readFile as readFile5, readdir as readdir2, rename, rm as rm7, writeFile as writeFile4 } from "fs/promises";
+import { homedir as homedir10 } from "os";
+import { dirname as dirname5, join as join18, relative } from "path";
 
 class YoqaRunnerError extends Error {
   constructor(message) {
@@ -103680,7 +104241,7 @@ function normalizeTeamId(value) {
 }
 async function readSavedTeam(settingsPath) {
   try {
-    const parsed = JSON.parse(await readFile4(settingsPath, "utf8"));
+    const parsed = JSON.parse(await readFile5(settingsPath, "utf8"));
     return typeof parsed.team === "string" ? normalizeTeamId(parsed.team) : null;
   } catch {
     return null;
@@ -103688,7 +104249,7 @@ async function readSavedTeam(settingsPath) {
 }
 async function saveTeam(settingsPath, team) {
   if (team === null) {
-    await rm6(settingsPath, { force: true });
+    await rm7(settingsPath, { force: true });
     return;
   }
   await mkdir4(dirname5(settingsPath), { recursive: true });
@@ -103757,16 +104318,16 @@ async function hashSources(projectDir) {
       entries = (await readdir2(path)).sort();
     } catch {
       hash.update(`${relative(projectDir, path)}\x00`);
-      hash.update(await readFile4(path));
+      hash.update(await readFile5(path));
       return;
     }
     for (const entry of entries) {
       if (!IGNORED.has(entry))
-        await visit9(join17(path, entry));
+        await visit9(join18(path, entry));
     }
   };
   for (const entry of SOURCE_ENTRIES) {
-    const path = join17(projectDir, entry);
+    const path = join18(projectDir, entry);
     if (existsSync5(path))
       await visit9(path);
   }
@@ -103787,11 +104348,11 @@ function parseProfile(plist) {
   };
 }
 async function readProfiles(products, exec) {
-  const platform = join17(products, "Debug-iphoneos");
+  const platform = join18(products, "Debug-iphoneos");
   const apps2 = (await readdir2(platform).catch(() => [])).filter((name30) => name30.endsWith(".app"));
   const profiles = [];
   for (const app of apps2) {
-    const path = join17(platform, app, "embedded.mobileprovision");
+    const path = join18(platform, app, "embedded.mobileprovision");
     if (!existsSync5(path))
       continue;
     const decoded = await exec(["security", "cms", "-D", "-i", path]);
@@ -103806,7 +104367,7 @@ function usableFor(manifest, udid, now) {
 }
 async function readManifest(path) {
   try {
-    return JSON.parse(await readFile4(path, "utf8"));
+    return JSON.parse(await readFile5(path, "utf8"));
   } catch {
     return null;
   }
@@ -103814,14 +104375,14 @@ async function readManifest(path) {
 async function findXctestrun(products) {
   const entries = await readdir2(products).catch(() => []);
   const name30 = entries.find((entry) => entry.endsWith(".xctestrun"));
-  return name30 ? join17(products, name30) : null;
+  return name30 ? join18(products, name30) : null;
 }
 async function brandRunnerApp(products, exec) {
-  const platform = join17(products, "Debug-iphoneos");
-  const host = join17(platform, "YoqaRunner.app");
-  const runner = join17(platform, "YoqaRunnerUITests-Runner.app");
-  const staging = join17(products, "branding");
-  const copy = join17(staging, "YoqaRunnerUITests-Runner.app");
+  const platform = join18(products, "Debug-iphoneos");
+  const host = join18(platform, "YoqaRunner.app");
+  const runner = join18(platform, "YoqaRunnerUITests-Runner.app");
+  const staging = join18(products, "branding");
+  const copy = join18(staging, "YoqaRunnerUITests-Runner.app");
   const run = async (command) => {
     const result = await exec(command);
     if (result.exitCode !== 0) {
@@ -103833,10 +104394,10 @@ async function brandRunnerApp(products, exec) {
     const icons = (await readdir2(host)).filter((name30) => name30.startsWith("AppIcon") || name30 === "Assets.car");
     if (!icons.some((name30) => name30.startsWith("AppIcon")))
       return "the host app has no AppIcon";
-    await rm6(staging, { recursive: true, force: true });
+    await rm7(staging, { recursive: true, force: true });
     await cp(runner, copy, { recursive: true, verbatimSymlinks: true });
     for (const name30 of icons)
-      await copyFile(join17(host, name30), join17(copy, name30));
+      await copyFile(join18(host, name30), join18(copy, name30));
     const plist = await run([
       "plutil",
       "-extract",
@@ -103844,7 +104405,7 @@ async function brandRunnerApp(products, exec) {
       "json",
       "-o",
       "-",
-      join17(host, "Info.plist")
+      join18(host, "Info.plist")
     ]);
     await run([
       "plutil",
@@ -103852,11 +104413,11 @@ async function brandRunnerApp(products, exec) {
       "CFBundleIcons",
       "-json",
       plist.trim(),
-      join17(copy, "Info.plist")
+      join18(copy, "Info.plist")
     ]);
-    const certificates = join17(staging, "certificate");
+    const certificates = join18(staging, "certificate");
     await run(["codesign", "-d", `--extract-certificates=${certificates}`, runner]);
-    const identity2 = createHash("sha1").update(await readFile4(`${certificates}0`)).digest("hex").toUpperCase();
+    const identity2 = createHash("sha1").update(await readFile5(`${certificates}0`)).digest("hex").toUpperCase();
     await run([
       "codesign",
       "--force",
@@ -103866,7 +104427,7 @@ async function brandRunnerApp(products, exec) {
       "--generate-entitlement-der",
       copy
     ]);
-    const unbranded = join17(staging, "unbranded.app");
+    const unbranded = join18(staging, "unbranded.app");
     await rename(runner, unbranded);
     try {
       await rename(copy, runner);
@@ -103878,7 +104439,7 @@ async function brandRunnerApp(products, exec) {
   } catch (error40) {
     return error40 instanceof Error ? error40.message : String(error40);
   } finally {
-    await rm6(staging, { recursive: true, force: true });
+    await rm7(staging, { recursive: true, force: true });
   }
 }
 function xcodeVersion(result) {
@@ -103938,14 +104499,17 @@ function prepareYoqaRunner(udid, deps) {
   return next;
 }
 async function prepare(udid, deps) {
+  if (!existsSync5(join18(deps.projectDir, "YoqaRunner.xcodeproj"))) {
+    throw new YoqaRunnerError(`YoqaRunner's Xcode project is missing from this install (looked in ${deps.projectDir}). Reinstall yoqa, or set YOQA_RUNNER_PROJECT to a native/yoqa-runner checkout.`);
+  }
   const team = await signingTeam(deps);
   const [sources, xcode] = await Promise.all([
     hashSources(deps.projectDir),
     deps.exec(["xcodebuild", "-version"])
   ]);
   const key = createHash("sha256").update(`${sources}\x00${xcodeVersion(xcode)}\x00${team}`).digest("hex").slice(0, 16);
-  const dir = join17(deps.cacheRoot, key);
-  const manifestPath = join17(dir, "build.json");
+  const dir = join18(deps.cacheRoot, key);
+  const manifestPath = join18(dir, "build.json");
   const cached2 = await readManifest(manifestPath);
   if (cached2 && usableFor(cached2, udid, deps.now())) {
     return {
@@ -103956,12 +104520,12 @@ async function prepare(udid, deps) {
       devices: cached2.devices
     };
   }
-  const derivedData = join17(dir, "DerivedData");
+  const derivedData = join18(dir, "DerivedData");
   const build = await deps.exec([
     "xcodebuild",
     "build-for-testing",
     "-project",
-    join17(deps.projectDir, "YoqaRunner.xcodeproj"),
+    join18(deps.projectDir, "YoqaRunner.xcodeproj"),
     "-scheme",
     "YoqaRunner",
     "-destination",
@@ -103978,7 +104542,7 @@ async function prepare(udid, deps) {
     throw new YoqaRunnerError(explainBuildFailure(`${build.stdout}
 ${build.stderr}`, team));
   }
-  const products = join17(derivedData, "Build/Products");
+  const products = join18(derivedData, "Build/Products");
   const unbranded = await brandRunnerApp(products, deps.exec);
   if (unbranded)
     console.warn(`[yoqa-runner] the runner keeps Xcode's blank icon: ${unbranded}`);
@@ -104005,7 +104569,7 @@ ${build.stderr}`, team));
     devices: manifest.devices
   };
 }
-var READY_TIMEOUT_MS3 = 120000;
+var READY_TIMEOUT_MS4 = 120000;
 var LISTENING_RE = /YOQA_RUNNER_LISTENING port=(\d+)/;
 var LAUNCH_FAILED_RE = /IDELaunchReport: .*Finished with error:|Failed to install or launch the test runner/;
 var OUTPUT_TAIL_CHARS = 16000;
@@ -104035,7 +104599,7 @@ function drain(stream, onLine) {
 }
 async function startYoqaRunner(udid, deps) {
   const build = await prepareYoqaRunner(udid, deps);
-  const readyTimeoutMs = deps.readyTimeoutMs ?? READY_TIMEOUT_MS3;
+  const readyTimeoutMs = deps.readyTimeoutMs ?? READY_TIMEOUT_MS4;
   const env = {};
   const port = deps.env.YOQA_RUNNER_PORT?.trim();
   if (port)
@@ -104128,7 +104692,36 @@ async function execCommand(command) {
     return { stdout: "", stderr: `failed to spawn: ${command[0]}`, exitCode: 127 };
   }
 }
+var RUNNER_SOURCE_ARCHIVE = "yoqa-runner-src.tar.gz";
+function resolveYoqaRunnerProject(at) {
+  const fromEnv = at.env.YOQA_RUNNER_PROJECT?.trim();
+  if (fromEnv)
+    return fromEnv;
+  if (existsSync5(join18(at.checkout, "YoqaRunner.xcodeproj")))
+    return at.checkout;
+  if (!existsSync5(at.archive))
+    return at.checkout;
+  const key = createHash("sha256").update(readFileSync(at.archive)).digest("hex").slice(0, 16);
+  const dir = join18(at.cacheRoot, "source", key);
+  if (existsSync5(join18(dir, "YoqaRunner.xcodeproj")))
+    return dir;
+  const staging = `${dir}.${process.pid}.tmp`;
+  rmSync(staging, { recursive: true, force: true });
+  mkdirSync2(staging, { recursive: true });
+  const tar = Bun.spawnSync(["tar", "-xzf", at.archive, "-C", staging]);
+  if (tar.exitCode !== 0) {
+    rmSync(staging, { recursive: true, force: true });
+    return at.checkout;
+  }
+  try {
+    renameSync(staging, dir);
+  } catch {
+    rmSync(staging, { recursive: true, force: true });
+  }
+  return dir;
+}
 function yoqaRunnerDeps() {
+  const cacheRoot = join18(homedir10(), ".yoqa", "yoqa-runner");
   return {
     exec: execCommand,
     spawn: (command, env) => Bun.spawn(command, {
@@ -104138,9 +104731,14 @@ function yoqaRunnerDeps() {
       stderr: "pipe"
     }),
     env: process.env,
-    projectDir: join17(import.meta.dir, "../../../../../native/yoqa-runner"),
-    cacheRoot: join17(homedir9(), ".yoqa", "yoqa-runner"),
-    settingsPath: join17(homedir9(), ".yoqa", "ios-signing.json"),
+    projectDir: resolveYoqaRunnerProject({
+      env: process.env,
+      checkout: join18(import.meta.dir, "../../../../../native/yoqa-runner"),
+      archive: join18(dirname5(process.execPath), RUNNER_SOURCE_ARCHIVE),
+      cacheRoot
+    }),
+    cacheRoot,
+    settingsPath: join18(homedir10(), ".yoqa", "ios-signing.json"),
     now: () => new Date
   };
 }
@@ -104152,6 +104750,15 @@ var SWIPE_MS = 400;
 var DRAG_PRESS_MS = 500;
 var BACKSPACE = String.fromCharCode(8);
 var KEY_SEPARATORS = new RegExp(`(\\r?\\n|${BACKSPACE})`);
+var PHONE_KEYS = {
+  Enter: ["keyboardReturn", {}],
+  Backspace: ["keyboardDelete", {}],
+  Space: ["type", { text: " " }]
+};
+var PHONE_KEY_SUPPORT = {
+  keys: Object.keys(PHONE_KEYS),
+  modifiers: false
+};
 var RECORDING_PULL_MS = 400;
 var UNREACHABLE_GRACE_MS = 20000;
 function errorMessage5(error40) {
@@ -104375,7 +104982,7 @@ async function createIosDeviceSession(options, deps = iosDeviceDeps()) {
   const screenshot = async () => {
     await mkdir5(SCREENSHOT_DIR, { recursive: true });
     const frame = await captureFrame();
-    const path = join18(SCREENSHOT_DIR, `shot_${Date.now()}_${crypto.randomUUID()}.png`);
+    const path = join19(SCREENSHOT_DIR, `shot_${Date.now()}_${crypto.randomUUID()}.png`);
     await Bun.write(path, Uint8Array.from(Buffer.from(frame.base64, "base64")));
     return { path, base64: frame.base64 };
   };
@@ -104429,6 +105036,12 @@ async function createIosDeviceSession(options, deps = iosDeviceDeps()) {
     swipe: (x1, y1, x2, y2, durationMs = SWIPE_MS) => withActionLock(() => dragNorm({ x: x1, y: y1 }, { x: x2, y: y2 }, durationMs, SWIPE_PRESS_MS)),
     drag: (x1, y1, x2, y2, durationMs = 800) => withActionLock(() => dragNorm({ x: x1, y: y1 }, { x: x2, y: y2 }, durationMs, DRAG_PRESS_MS)),
     type: (text3) => withActionLock(() => typeText(text3)),
+    keySupport: PHONE_KEY_SUPPORT,
+    key: async (name30, modifiers = []) => {
+      assertKeySupported(PHONE_KEY_SUPPORT, "on a cabled iPhone", name30, modifiers);
+      const [command, fields] = PHONE_KEYS[name30];
+      await withActionLock(() => call(command, fields, true));
+    },
     activateApp: async (id) => {
       await devicectl(["device", "process", "launch", "--device", udid, id], "devicectl launch");
       appId = id;
@@ -104494,21 +105107,645 @@ function directImplementationOrder(implementations, optIn) {
 var OPT_IN_ENV = {
   android: "YOQA_DIRECT_ANDROID",
   "ios-simulator": "YOQA_DIRECT_IOS_SIMULATOR",
-  "ios-device": "YOQA_DIRECT_IOS_DEVICE"
+  "ios-device": "YOQA_DIRECT_IOS_DEVICE",
+  web: "YOQA_DIRECT_WEB"
 };
 function directOptIn(deviceClass, env = process.env) {
   const value = env[OPT_IN_ENV[deviceClass]]?.trim();
   return value ? value : undefined;
 }
 
+// src/domains/devices/web-direct-lane.ts
+import { mkdir as mkdir6 } from "fs/promises";
+import { join as join20 } from "path";
+
+// src/domains/devices/cdp-client.ts
+class CdpClosedError extends Error {
+  constructor(message = "The browser's DevTools connection closed") {
+    super(message);
+    this.name = "CdpClosedError";
+  }
+}
+
+class CdpCommandError extends Error {
+  method;
+  code;
+  constructor(method, code, message) {
+    super(`${method}: ${message}`);
+    this.method = method;
+    this.code = code;
+    this.name = "CdpCommandError";
+  }
+}
+var COMMAND_TIMEOUT_MS2 = 30000;
+var CONNECT_TIMEOUT_MS = 5000;
+async function connectCdp(url2, options = {}) {
+  const connectTimeoutMs = options.connectTimeoutMs ?? CONNECT_TIMEOUT_MS;
+  const socket = new WebSocket(url2);
+  await new Promise((resolve7, reject) => {
+    const timer = setTimeout(() => {
+      socket.close();
+      reject(new Error(`No DevTools socket at ${url2} within ${connectTimeoutMs} ms`));
+    }, connectTimeoutMs);
+    socket.addEventListener("open", () => {
+      clearTimeout(timer);
+      resolve7();
+    });
+    socket.addEventListener("error", () => {
+      clearTimeout(timer);
+      reject(new Error(`Could not open the DevTools socket at ${url2}`));
+    });
+  });
+  const commandTimeoutMs = options.commandTimeoutMs ?? COMMAND_TIMEOUT_MS2;
+  const pending = new Map;
+  const listeners = new Map;
+  let nextId = 1;
+  let isClosed = false;
+  let markClosed = () => {
+    return;
+  };
+  const closed = new Promise((resolve7) => {
+    markClosed = resolve7;
+  });
+  const onClosed = () => {
+    if (isClosed)
+      return;
+    isClosed = true;
+    for (const entry of pending.values()) {
+      clearTimeout(entry.timer);
+      entry.reject(new CdpClosedError);
+    }
+    pending.clear();
+    markClosed();
+  };
+  socket.addEventListener("close", onClosed);
+  socket.addEventListener("error", onClosed);
+  socket.addEventListener("message", (event) => {
+    let message;
+    try {
+      message = JSON.parse(String(event.data));
+    } catch {
+      return;
+    }
+    if (message.id !== undefined) {
+      const entry = pending.get(message.id);
+      if (!entry)
+        return;
+      pending.delete(message.id);
+      clearTimeout(entry.timer);
+      if (message.error) {
+        entry.reject(new CdpCommandError(entry.method, message.error.code, message.error.message ?? "failed"));
+      } else {
+        entry.resolve(message.result ?? {});
+      }
+      return;
+    }
+    if (message.method) {
+      for (const listener of listeners.get(message.method) ?? []) {
+        listener(message.params, message.sessionId);
+      }
+    }
+  });
+  return {
+    send: (method, params, sessionId) => {
+      if (isClosed)
+        return Promise.reject(new CdpClosedError);
+      const id = nextId++;
+      return new Promise((resolve7, reject) => {
+        const timer = setTimeout(() => {
+          pending.delete(id);
+          reject(new Error(`${method}: the browser did not answer within ${commandTimeoutMs} ms`));
+        }, commandTimeoutMs);
+        pending.set(id, {
+          method,
+          resolve: resolve7,
+          reject,
+          timer
+        });
+        socket.send(JSON.stringify({ id, method, params, ...sessionId ? { sessionId } : {} }));
+      });
+    },
+    on: (method, listener) => {
+      const set2 = listeners.get(method) ?? new Set;
+      set2.add(listener);
+      listeners.set(method, set2);
+      return () => {
+        set2.delete(listener);
+      };
+    },
+    closed,
+    close: async () => {
+      if (isClosed)
+        return;
+      socket.close();
+      await closed;
+    }
+  };
+}
+
+// src/domains/devices/chromium-attach.ts
+var ATTACH_ID = /^chromium-cdp-(\d{1,5})$/;
+var PROBE_TIMEOUT_MS = 2000;
+function attachPortOf(deviceId) {
+  const match = ATTACH_ID.exec(deviceId);
+  const port = Number(match?.[1]);
+  return match && port >= 1 && port <= 65535 ? port : null;
+}
+
+class NoCdpEndpointError extends Error {
+  port;
+  constructor(port, reason) {
+    super(`No Chromium DevTools endpoint on port ${port} (${reason}). Start Chrome, Edge or Brave with --remote-debugging-port=${port} and a non-default --user-data-dir: Chrome 136 and later turn remote debugging off on the default profile.`);
+    this.port = port;
+    this.name = "NoCdpEndpointError";
+  }
+}
+async function browserSocketUrl(port, fetchFn = fetch) {
+  let response;
+  try {
+    response = await fetchFn(`http://127.0.0.1:${port}/json/version`, {
+      signal: AbortSignal.timeout(PROBE_TIMEOUT_MS)
+    });
+  } catch (error40) {
+    throw new NoCdpEndpointError(port, error40 instanceof Error ? error40.message : String(error40));
+  }
+  if (!response.ok)
+    throw new NoCdpEndpointError(port, `/json/version answered ${response.status}`);
+  const body = await response.json().catch(() => null);
+  const url2 = body?.webSocketDebuggerUrl;
+  if (typeof url2 !== "string" || !url2.startsWith("ws")) {
+    throw new NoCdpEndpointError(port, "/json/version named no DevTools socket");
+  }
+  return url2;
+}
+
+// src/domains/devices/web-direct-lane.ts
+var NEWLINE = /(\r?\n)/;
+var DRAG_STEPS = 10;
+var DEFAULT_DRAG_MS = 800;
+var DEFAULT_SWIPE_MS = 400;
+var NAVIGATE_LOAD_MS = 1e4;
+var MOBILE_USER_AGENT = "Mozilla/5.0 (iPhone; CPU iPhone OS 18_0 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/18.0 Mobile/15E148 Safari/604.1";
+var CDP_KEYS = {
+  Enter: { key: "Enter", code: "Enter", windowsVirtualKeyCode: 13, text: "\r" },
+  Tab: { key: "Tab", code: "Tab", windowsVirtualKeyCode: 9 },
+  Escape: { key: "Escape", code: "Escape", windowsVirtualKeyCode: 27 },
+  Backspace: { key: "Backspace", code: "Backspace", windowsVirtualKeyCode: 8 },
+  Delete: { key: "Delete", code: "Delete", windowsVirtualKeyCode: 46 },
+  ArrowUp: { key: "ArrowUp", code: "ArrowUp", windowsVirtualKeyCode: 38 },
+  ArrowDown: { key: "ArrowDown", code: "ArrowDown", windowsVirtualKeyCode: 40 },
+  ArrowLeft: { key: "ArrowLeft", code: "ArrowLeft", windowsVirtualKeyCode: 37 },
+  ArrowRight: { key: "ArrowRight", code: "ArrowRight", windowsVirtualKeyCode: 39 },
+  Home: { key: "Home", code: "Home", windowsVirtualKeyCode: 36 },
+  End: { key: "End", code: "End", windowsVirtualKeyCode: 35 },
+  PageUp: { key: "PageUp", code: "PageUp", windowsVirtualKeyCode: 33 },
+  PageDown: { key: "PageDown", code: "PageDown", windowsVirtualKeyCode: 34 },
+  Space: { key: " ", code: "Space", windowsVirtualKeyCode: 32, text: " " }
+};
+var CDP_MODIFIERS = {
+  Shift: { key: "Shift", code: "ShiftLeft", windowsVirtualKeyCode: 16, bit: 8 },
+  Control: { key: "Control", code: "ControlLeft", windowsVirtualKeyCode: 17, bit: 2 },
+  Alt: { key: "Alt", code: "AltLeft", windowsVirtualKeyCode: 18, bit: 1 },
+  Meta: { key: "Meta", code: "MetaLeft", windowsVirtualKeyCode: 91, bit: 4 }
+};
+var WEB_KEY_SUPPORT = { keys: KEY_NAMES, modifiers: true };
+function webDirectDeps(overrides = {}) {
+  return {
+    browserSocketUrl: (port) => browserSocketUrl(port),
+    connect: (url2) => connectCdp(url2),
+    installedBrowsers: overrides.installedBrowsers ?? (() => findInstalledBrowsers()),
+    launch: (browser) => launchChromium(browser, { spawn: overrides.spawn })
+  };
+}
+async function openBrowser(deviceId, deps) {
+  const port = attachPortOf(deviceId);
+  if (port !== null) {
+    return { socketUrl: await deps.browserSocketUrl(port), owned: null, name: null };
+  }
+  const browserId = installedBrowserIdOf(deviceId);
+  if (browserId === null) {
+    throw new Error("A web device is an installed browser (web-chrome, web-edge, web-brave, web-chromium) or a Chromium started with --remote-debugging-port, named chromium-cdp-<port>");
+  }
+  const browser = (await deps.installedBrowsers()).find((installed) => installed.id === browserId);
+  if (!browser) {
+    throw new Error(`${browserId} is not installed. Run yoqa devices web to list the browsers here`);
+  }
+  const owned = await deps.launch(browser);
+  const name30 = browser.version ? `${browser.name} ${browser.version}` : browser.name;
+  return { socketUrl: owned.socketUrl, owned, name: name30 };
+}
+async function pickPage(client) {
+  const { targetInfos } = await client.send("Target.getTargets", {});
+  const page = targetInfos.find((target) => target.type === "page" && !target.url.startsWith("devtools://"));
+  if (page)
+    return page.targetId;
+  return (await client.send("Target.createTarget", { url: "about:blank" })).targetId;
+}
+function layoutByBackendId(documents, strings) {
+  const layouts = new Map;
+  const doc2 = documents[0];
+  if (!doc2)
+    return layouts;
+  const scrollX = doc2.scrollOffsetX ?? 0;
+  const scrollY = doc2.scrollOffsetY ?? 0;
+  doc2.layout.nodeIndex.forEach((nodeIndex, layoutIndex) => {
+    const backendId = doc2.nodes.backendNodeId?.[nodeIndex];
+    const [x = 0, y = 0, width = 0, height = 0] = doc2.layout.bounds[layoutIndex] ?? [];
+    if (backendId === undefined || layouts.has(backendId))
+      return;
+    const layout = { bounds: { x: x - scrollX, y: y - scrollY, width, height } };
+    const attributes = doc2.nodes.attributes?.[nodeIndex] ?? [];
+    for (let at = 0;at + 1 < attributes.length; at += 2) {
+      const name30 = strings[attributes[at] ?? -1];
+      const value = strings[attributes[at + 1] ?? -1];
+      if (name30 === "data-testid" && value)
+        layout.testId = value;
+      if (name30 === "id" && value)
+        layout.domId = value;
+    }
+    layouts.set(backendId, layout);
+  });
+  return layouts;
+}
+function webUrlOf(appId) {
+  const url2 = URL.canParse(appId) ? new URL(appId) : null;
+  if (url2?.protocol !== "http:" && url2?.protocol !== "https:") {
+    throw new Error(`On web an app is its Web URL (http or https), and "${appId}" is not one`);
+  }
+  return url2;
+}
+function originOf(url2) {
+  return URL.canParse(url2) ? new URL(url2).origin : null;
+}
+async function attachPage(client, targetId, preset) {
+  const { sessionId } = await client.send("Target.attachToTarget", { targetId, flatten: true });
+  await client.send("Page.enable", {}, sessionId);
+  const { width, height, deviceScaleFactor, mobile } = preset;
+  await client.send("Emulation.setDeviceMetricsOverride", { width, height, deviceScaleFactor, mobile }, sessionId);
+  if (mobile) {
+    await client.send("Emulation.setTouchEmulationEnabled", { enabled: true, maxTouchPoints: 5 }, sessionId);
+    await client.send("Emulation.setUserAgentOverride", { userAgent: MOBILE_USER_AGENT }, sessionId);
+  }
+  await client.send("Page.bringToFront", {}, sessionId);
+  return { targetId, sessionId };
+}
+async function createWebDirectSession(options, deps = webDirectDeps()) {
+  if (options.platform !== "web") {
+    throw new Error("The web Direct lane drives web devices only");
+  }
+  const preset = VIEWPORT_PRESETS[options.viewport ?? DEFAULT_VIEWPORT_PRESET];
+  const { socketUrl, owned, name: name30 } = await openBrowser(options.deviceId, deps);
+  const client = await deps.connect(socketUrl).catch(async (error40) => {
+    await owned?.stop();
+    throw error40;
+  });
+  let page;
+  let browser;
+  try {
+    page = await attachPage(client, await pickPage(client), preset);
+    await client.send("Target.setDiscoverTargets", { discover: true });
+    browser = name30 ?? (await client.send("Browser.getVersion", {})).product.replace("/", " ");
+  } catch (error40) {
+    await client.close().catch(() => {
+      return;
+    });
+    await owned?.stop();
+    throw error40;
+  }
+  let quitting = false;
+  let sessionEnded = null;
+  const dead = (reason) => {
+    if (!sessionEnded) {
+      sessionEnded = new DeadSessionError(`Device session ended: ${reason}`);
+      if (!quitting) {
+        owned?.stop();
+        options.onSessionDead?.();
+      }
+    }
+    return sessionEnded;
+  };
+  client.closed.then(() => {
+    if (!quitting)
+      dead("the browser closed its DevTools connection");
+  });
+  owned?.exited.then(() => {
+    if (!quitting)
+      dead("the browser quit");
+  });
+  let openDialog = null;
+  const openers = [];
+  let switching = Promise.resolve();
+  const switchPage = (fn) => {
+    switching = switching.then(fn).catch(() => {
+      return;
+    });
+  };
+  client.on("Target.targetCreated", (params) => {
+    const { targetInfo } = params;
+    if (targetInfo.type !== "page" || !targetInfo.openerId)
+      return;
+    switchPage(async () => {
+      if (targetInfo.openerId !== page.targetId || sessionEnded)
+        return;
+      const popup = await attachPage(client, targetInfo.targetId, preset);
+      openers.push(page);
+      page = popup;
+      openDialog = null;
+    });
+  });
+  client.on("Target.detachedFromTarget", (params) => {
+    const { sessionId } = params ?? {};
+    const closedOpener = openers.findIndex((opener2) => opener2.sessionId === sessionId);
+    if (closedOpener >= 0)
+      openers.splice(closedOpener, 1);
+    if (sessionId !== page.sessionId || quitting)
+      return;
+    const opener = openers.pop();
+    if (!opener) {
+      dead("the page was closed");
+      return;
+    }
+    page = opener;
+    openDialog = null;
+    switchPage(() => client.send("Page.bringToFront", {}, opener.sessionId));
+  });
+  client.on("Page.javascriptDialogOpening", (params, eventSession) => {
+    if (eventSession === page.sessionId)
+      openDialog = params;
+  });
+  client.on("Page.javascriptDialogClosed", (_params, eventSession) => {
+    if (eventSession === page.sessionId)
+      openDialog = null;
+  });
+  const guarded = async (fn) => {
+    if (sessionEnded)
+      throw sessionEnded;
+    try {
+      return await fn();
+    } catch (error40) {
+      if (error40 instanceof CdpClosedError && !quitting)
+        throw dead(error40.message);
+      throw error40;
+    }
+  };
+  const call = (method, params) => guarded(async () => {
+    await switching;
+    return client.send(method, params, page.sessionId);
+  });
+  const callBrowser = (method, params) => guarded(() => client.send(method, params));
+  let chain = Promise.resolve();
+  const withActionLock = (fn) => {
+    const after = () => switching.then(fn);
+    const run = chain.then(after, after);
+    chain = run.catch(() => {
+      return;
+    });
+    return run;
+  };
+  const getWindowSize = () => guarded(async () => {
+    await switching;
+    return { width: preset.width, height: preset.height };
+  });
+  const toPage = async (xNorm, yNorm) => {
+    const viewport = await getWindowSize();
+    return { x: xNorm / 1000 * viewport.width, y: yNorm / 1000 * viewport.height };
+  };
+  const mouse = (type, point, held = false) => {
+    if (type === "mouseMoved") {
+      return call("Input.dispatchMouseEvent", {
+        type,
+        ...point,
+        button: held ? "left" : "none",
+        buttons: held ? 1 : 0
+      });
+    }
+    return call("Input.dispatchMouseEvent", {
+      type,
+      ...point,
+      button: "left",
+      buttons: type === "mousePressed" ? 1 : 0,
+      clickCount: 1
+    });
+  };
+  const touch = (type, point) => call("Input.dispatchTouchEvent", { type, touchPoints: type === "touchEnd" ? [] : [point] });
+  const pointer = preset.mobile ? {
+    press: (point) => touch("touchStart", point),
+    move: (point) => touch("touchMove", point),
+    release: (point) => touch("touchEnd", point)
+  } : {
+    press: async (point) => {
+      await mouse("mouseMoved", point);
+      await mouse("mousePressed", point);
+    },
+    move: (point) => mouse("mouseMoved", point, true),
+    release: (point) => mouse("mouseReleased", point)
+  };
+  const click = async (xNorm, yNorm, holdMs = 0) => {
+    const point = await toPage(xNorm, yNorm);
+    await pointer.press(point);
+    if (holdMs > 0)
+      await Bun.sleep(holdMs);
+    await pointer.release(point);
+  };
+  const stroke = async (from, to, durationMs) => {
+    await pointer.press(from);
+    for (let step = 1;step <= DRAG_STEPS; step++) {
+      await Bun.sleep(durationMs / DRAG_STEPS);
+      const t = step / DRAG_STEPS;
+      await pointer.move({ x: from.x + (to.x - from.x) * t, y: from.y + (to.y - from.y) * t });
+    }
+    await pointer.release(to);
+  };
+  const scroll = async (x1, y1, x2, y2, durationMs = DEFAULT_SWIPE_MS) => {
+    const from = await toPage(x1, y1);
+    const to = await toPage(x2, y2);
+    if (preset.mobile) {
+      await stroke(from, to, durationMs);
+      return;
+    }
+    await call("Input.dispatchMouseEvent", {
+      type: "mouseWheel",
+      ...from,
+      deltaX: from.x - to.x,
+      deltaY: from.y - to.y
+    });
+  };
+  const drag = async (x1, y1, x2, y2, durationMs = DEFAULT_DRAG_MS) => {
+    await stroke(await toPage(x1, y1), await toPage(x2, y2), durationMs);
+  };
+  const answerDialog = async (accept) => {
+    const promptText = accept && openDialog?.type === "prompt" ? openDialog.defaultPrompt ?? "" : undefined;
+    try {
+      await call("Page.handleJavaScriptDialog", {
+        accept,
+        ...promptText !== undefined ? { promptText } : {}
+      });
+    } catch (error40) {
+      if (error40 instanceof CdpCommandError && /no dialog is showing/i.test(error40.message)) {
+        throw new Error("No JavaScript dialog is open on the page");
+      }
+      throw error40;
+    }
+    openDialog = null;
+  };
+  const navigate = async (url2) => {
+    let loaded = () => {};
+    const load = new Promise((resolve7) => {
+      loaded = resolve7;
+    });
+    const stopListening = client.on("Page.loadEventFired", (_params, eventSession) => {
+      if (eventSession === page.sessionId)
+        loaded();
+    });
+    try {
+      const { errorText, loaderId } = await call("Page.navigate", { url: url2 });
+      if (errorText)
+        throw new Error(`Could not open ${url2}: ${errorText}`);
+      if (loaderId)
+        await Promise.race([load, client.closed, Bun.sleep(NAVIGATE_LOAD_MS)]);
+    } finally {
+      stopListening();
+    }
+  };
+  const closeAppPage = async () => {
+    const appPage = page;
+    const { targetId } = await callBrowser("Target.createTarget", { url: "about:blank" });
+    page = await guarded(() => attachPage(client, targetId, preset));
+    openDialog = null;
+    await callBrowser("Target.closeTarget", { targetId: appPage.targetId });
+  };
+  const openApp = async (url2) => {
+    const { targetInfo } = await callBrowser("Target.getTargetInfo", { targetId: page.targetId });
+    if (originOf(targetInfo.url) === url2.origin)
+      await call("Page.bringToFront", {});
+    else
+      await navigate(url2.href);
+  };
+  const pressKey = async (name50, modifiers = []) => {
+    let held = 0;
+    for (const modifier of modifiers) {
+      const { bit, ...key2 } = CDP_MODIFIERS[modifier];
+      held |= bit;
+      await call("Input.dispatchKeyEvent", { type: "rawKeyDown", ...key2, modifiers: held });
+    }
+    const { text: text3, ...key } = CDP_KEYS[name50];
+    const shortcut = modifiers.some((modifier) => modifier !== "Shift");
+    await call("Input.dispatchKeyEvent", text3 && !shortcut ? { type: "keyDown", ...key, text: text3, modifiers: held } : { type: "rawKeyDown", ...key, modifiers: held });
+    await call("Input.dispatchKeyEvent", { type: "keyUp", ...key, modifiers: held });
+    for (const modifier of [...modifiers].reverse()) {
+      const { bit, ...key2 } = CDP_MODIFIERS[modifier];
+      held &= ~bit;
+      await call("Input.dispatchKeyEvent", { type: "keyUp", ...key2, modifiers: held });
+    }
+  };
+  const typeText = async (text3) => {
+    for (const part2 of text3.split(NEWLINE)) {
+      if (part2 === "")
+        continue;
+      if (part2 === `
+` || part2 === `\r
+`)
+        await pressKey("Enter");
+      else
+        await call("Input.insertText", { text: part2 });
+    }
+  };
+  const captureFrame = async () => {
+    const { data } = await call("Page.captureScreenshot", { format: "png" });
+    if (!data)
+      throw new Error("The browser returned an empty screenshot");
+    return { base64: data, mime: "image/png" };
+  };
+  const screenshot = async () => {
+    await mkdir6(SCREENSHOT_DIR, { recursive: true });
+    const frame = await captureFrame();
+    const path = join20(SCREENSHOT_DIR, `shot_${Date.now()}_${crypto.randomUUID()}.png`);
+    await Bun.write(path, Uint8Array.from(Buffer.from(frame.base64, "base64")));
+    return { path, base64: frame.base64 };
+  };
+  const pageSource = async () => {
+    const [{ nodes }, snapshot] = await Promise.all([
+      call("Accessibility.getFullAXTree", {}),
+      call("DOMSnapshot.captureSnapshot", { computedStyles: [] })
+    ]);
+    const layouts = layoutByBackendId(snapshot.documents, snapshot.strings);
+    const axTree = nodes.map((node) => {
+      const layout = node.backendDOMNodeId === undefined ? undefined : layouts.get(node.backendDOMNodeId);
+      return layout ? { ...node, ...layout } : node;
+    });
+    return JSON.stringify({ axTree });
+  };
+  let pointerDown = false;
+  return {
+    lane: "direct",
+    stream: null,
+    browser,
+    viewport: preset.name,
+    noRecordingReason: "Run recording is not available on web",
+    quit: async () => {
+      quitting = true;
+      await client.close();
+      await owned?.stop();
+    },
+    captureFrame,
+    screenshot,
+    pageSource,
+    getWindowSize,
+    tap: (x, y, tapOptions) => withActionLock(() => click(x, y, tapOptions?.durationMs)),
+    swipe: (x1, y1, x2, y2, durationMs) => withActionLock(() => scroll(x1, y1, x2, y2, durationMs)),
+    drag: (x1, y1, x2, y2, durationMs) => withActionLock(() => drag(x1, y1, x2, y2, durationMs)),
+    type: (text3) => withActionLock(() => typeText(text3)),
+    keySupport: WEB_KEY_SUPPORT,
+    key: async (name50, modifiers = []) => {
+      assertKeySupported(WEB_KEY_SUPPORT, "on the web", name50, modifiers);
+      await withActionLock(() => pressKey(name50, modifiers));
+    },
+    activateApp: (appId) => withActionLock(() => openApp(webUrlOf(appId))),
+    setTargetApp: () => {
+      return;
+    },
+    terminateApp: (appId) => withActionLock(async () => {
+      webUrlOf(appId);
+      await closeAppPage();
+    }),
+    restartApp: (appId) => withActionLock(async () => {
+      const url2 = webUrlOf(appId);
+      await closeAppPage();
+      await callBrowser("Storage.clearDataForOrigin", {
+        origin: url2.origin,
+        storageTypes: "all"
+      });
+      await navigate(url2.href);
+    }),
+    backgroundApp: () => Promise.reject(new ActionUnsupportedError("background-app is not supported on web: a browser page has no background to send it to")),
+    openUrl: (url2) => withActionLock(() => navigate(url2)),
+    acceptAlert: () => withActionLock(() => answerDialog(true)),
+    dismissAlert: () => withActionLock(() => answerDialog(false)),
+    withActionLock,
+    pointerEvent: async (phase, xNorm, yNorm) => {
+      const point = await toPage(xNorm, yNorm);
+      if (phase === "begin") {
+        pointerDown = true;
+        await pointer.press(point);
+      } else if (phase === "move") {
+        await pointer.move(point);
+      } else {
+        pointerDown = false;
+        await pointer.release(point);
+      }
+    },
+    isPointerActive: () => pointerDown
+  };
+}
+
 // src/domains/devices/yoqa-ax.ts
 import { randomBytes } from "crypto";
-import { existsSync as existsSync6, rmSync } from "fs";
+import { existsSync as existsSync6, rmSync as rmSync2 } from "fs";
 import { createServer } from "net";
-import { join as join19 } from "path";
-var CONNECT_TIMEOUT_MS = 1e4;
+import { join as join21 } from "path";
+var CONNECT_TIMEOUT_MS2 = 1e4;
 var REQUEST_TIMEOUT_MS2 = 5000;
-var STOP_GRACE_MS2 = 2000;
+var STOP_GRACE_MS3 = 2000;
 function spawnProcess2(command) {
   return Bun.spawn(command, { stdin: "ignore", stdout: "ignore", stderr: "ignore" });
 }
@@ -104516,9 +105753,9 @@ function resolveYoqaAxBin() {
   const fromEnv = process.env.YOQA_AX_BIN?.trim();
   if (fromEnv)
     return fromEnv;
-  const products = join19(import.meta.dir, "../../../../../native/yoqa-ax/.build/out/Products");
+  const products = join21(import.meta.dir, "../../../../../native/yoqa-ax/.build/out/Products");
   for (const config2 of ["Release-iphonesimulator", "Debug-iphonesimulator"]) {
-    const built = join19(products, config2, "yoqa-ax");
+    const built = join21(products, config2, "yoqa-ax");
     if (existsSync6(built))
       return built;
   }
@@ -104635,15 +105872,15 @@ async function startYoqaAx(udid, options) {
     stopped = true;
     client?.close("is stopped");
     server.close();
-    rmSync(path, { force: true });
+    rmSync2(path, { force: true });
     const exited = await Promise.race([
       proc.exited.then(() => true),
-      Bun.sleep(STOP_GRACE_MS2).then(() => false)
+      Bun.sleep(STOP_GRACE_MS3).then(() => false)
     ]);
     if (!exited)
       proc.kill("SIGKILL");
   };
-  const timeoutMs = options.connectTimeoutMs ?? CONNECT_TIMEOUT_MS;
+  const timeoutMs = options.connectTimeoutMs ?? CONNECT_TIMEOUT_MS2;
   let timer;
   const outcome = await Promise.race([
     connected,
@@ -104717,9 +105954,14 @@ function createDirectLane(implementations, optIn) {
   };
 }
 function deviceClassFor(platform, deviceId) {
-  if (platform === "android")
-    return "android";
-  return looksLikePhysicalIosUdid(deviceId) ? "ios-device" : "ios-simulator";
+  switch (platform) {
+    case "android":
+      return "android";
+    case "ios":
+      return looksLikePhysicalIosUdid(deviceId) ? "ios-device" : "ios-simulator";
+    case "web":
+      return "web";
+  }
 }
 var DIRECT_IMPLEMENTATIONS = {
   android: [
@@ -104758,6 +106000,13 @@ var DIRECT_IMPLEMENTATIONS = {
       promoted: true,
       open: (options) => createIosDeviceSession(options)
     }
+  ],
+  web: [
+    {
+      name: "cdp",
+      promoted: true,
+      open: (options) => createWebDirectSession(options)
+    }
   ]
 };
 function defaultDirectLane(platform) {
@@ -104770,9 +106019,12 @@ function defaultDirectLane(platform) {
 // src/domains/devices/open-session.ts
 var openByDeviceId = new Map;
 function defaultLanesFor(platform) {
-  return {
-    ...platform === "android" || platform === "ios" ? { direct: defaultDirectLane(platform) } : {}
-  };
+  switch (platform) {
+    case "android":
+    case "ios":
+    case "web":
+      return { direct: defaultDirectLane(platform) };
+  }
 }
 function mergeLanes(platform, lanes) {
   const defaults = defaultLanesFor(platform);
@@ -104868,7 +106120,8 @@ function toInfo(current) {
     heldByRun: current.heldByRunId != null,
     ...current.heldByRunId != null ? { heldByRunId: current.heldByRunId } : {},
     lane: current.session.lane,
-    ...current.session.laneWarning ? { laneWarning: current.session.laneWarning } : {}
+    ...current.session.laneWarning ? { laneWarning: current.session.laneWarning } : {},
+    ...current.session.viewport ? { viewport: current.session.viewport } : {}
   };
 }
 function getActiveSession() {
@@ -104904,6 +106157,7 @@ async function createAndRegister(options) {
     bundleId: options.bundleId,
     appPackage: options.appPackage,
     requestedLane: options.requestedLane,
+    viewport: options.viewport,
     onSessionDead: () => {
       abandonActiveSession();
     }
@@ -105001,7 +106255,14 @@ async function acquireSessionForRun(options) {
   return { session, shared: true };
 }
 function targetAppFor(options) {
-  return options.platform === "ios" ? options.bundleId : options.appPackage;
+  switch (options.platform) {
+    case "ios":
+      return options.bundleId;
+    case "android":
+      return options.appPackage;
+    case "web":
+      return;
+  }
 }
 async function releaseSessionFromRun(runId, session, shared) {
   if (!shared) {
@@ -105021,11 +106282,11 @@ import {
   createDecipheriv,
   randomBytes as randomBytes2
 } from "crypto";
-import { chmodSync, existsSync as existsSync7, mkdirSync as mkdirSync2, readFileSync, writeFileSync } from "fs";
-import { homedir as homedir10 } from "os";
-import { dirname as dirname6, join as join20 } from "path";
-var YOQA_ROOT2 = join20(homedir10(), ".yoqa");
-var KEY_PATH = join20(YOQA_ROOT2, ".provider-key");
+import { chmodSync, existsSync as existsSync7, mkdirSync as mkdirSync3, readFileSync as readFileSync2, writeFileSync } from "fs";
+import { homedir as homedir11 } from "os";
+import { dirname as dirname6, join as join22 } from "path";
+var YOQA_ROOT2 = join22(homedir11(), ".yoqa");
+var KEY_PATH = join22(YOQA_ROOT2, ".provider-key");
 var ALGORITHM = "aes-256-gcm";
 var IV_LENGTH = 12;
 var KEY_LENGTH = 32;
@@ -105058,9 +106319,9 @@ function base64ToBytes(value) {
   return bytes;
 }
 function ensureProviderKey() {
-  mkdirSync2(YOQA_ROOT2, { recursive: true });
+  mkdirSync3(YOQA_ROOT2, { recursive: true });
   if (existsSync7(KEY_PATH)) {
-    const existing = toBytes(readFileSync(KEY_PATH));
+    const existing = toBytes(readFileSync2(KEY_PATH));
     if (existing.length === KEY_LENGTH) {
       return existing;
     }
@@ -105619,8 +106880,12 @@ async function performAction(session, body, options) {
     case "restart-app": {
       if (!body.appId)
         throw new ActionValidationError("restart-app requires appId");
-      await session.terminateApp(body.appId);
-      await session.activateApp(body.appId);
+      if (session.restartApp) {
+        await session.restartApp(body.appId);
+      } else {
+        await session.terminateApp(body.appId);
+        await session.activateApp(body.appId);
+      }
       break;
     }
     case "background-app": {
@@ -105633,6 +106898,18 @@ async function performAction(session, body, options) {
       await session.openUrl(body.url);
       break;
     }
+    case "key": {
+      if (!body.key)
+        throw new ActionValidationError("key requires a key");
+      try {
+        await session.key(body.key, body.modifiers);
+      } catch (error40) {
+        if (error40 instanceof UnsupportedKeyError)
+          throw new ActionValidationError(error40.message);
+        throw error40;
+      }
+      break;
+    }
     case "alert": {
       if (body.alertAction === "dismiss") {
         await session.dismissAlert();
@@ -105686,37 +106963,18 @@ async function readCleanedTree(readScreen2, session) {
   }
 }
 async function runTextAssert(input) {
-  const deadline = input.clock.now() + input.timeoutMs;
-  const seconds = Math.round(input.timeoutMs / 1000);
-  for (;; ) {
-    if (input.isAborted()) {
-      throw new Error("Aborted");
-    }
-    let readError = null;
-    let elements = null;
-    try {
-      elements = (await input.readScreen(input.session)).elements ?? [];
-    } catch (error40) {
-      if (isDeadSessionError(error40))
-        throw error40;
-      readError = error40;
-    }
-    if (elements) {
-      const found = screenHasText(elements, input.text);
-      if (input.assertion === "visible" && found)
-        return;
-      if (input.assertion === "not-visible" && !found)
-        return;
-    }
-    if (input.clock.now() >= deadline) {
-      if (readError) {
-        const message = readError instanceof Error ? readError.message : String(readError);
-        throw new Error(`Could not read the screen within ${seconds}s: ${message}`);
-      }
-      throw new Error(input.assertion === "visible" ? `Expected visible text not found within ${seconds}s: ${input.text}` : `Unexpected text still visible after ${seconds}s: ${input.text}`);
-    }
-    await input.clock.sleep(400);
-  }
+  const { met } = await checkScreen({
+    readScreen: () => input.readScreen(input.session),
+    text: input.text,
+    assertion: input.assertion,
+    timeoutMs: input.timeoutMs,
+    sleep: (ms) => input.clock.sleep(ms),
+    now: () => input.clock.now(),
+    isAborted: input.isAborted,
+    isDeadSession: isDeadSessionError
+  });
+  if (!met)
+    throw new Error(screenCheckMissMessage(input));
 }
 function isPointTap(decision) {
   return decision.type === "tap" && decision.x != null && decision.y != null && !isSystemPermissionLabel(decision.label);
@@ -105755,11 +107013,61 @@ async function executeScriptCase(deps) {
   const setCurrentCommand = deps.setCurrentCommand ?? noopSetCurrentCommand;
   let stepIdx = 0;
   let lastScreenshotUri = null;
-  try {
-    for (const action of deps.script.actions) {
+  const replay = async (actions) => {
+    for (const action of actions) {
       if (deps.isAborted()) {
         return "cancelled";
       }
+      if (action.type === "branch") {
+        const timeoutMs = action.timeoutMs ?? BRANCH_DEFAULT_TIMEOUT_MS;
+        const { assertion } = action;
+        const target = action.id != null ? { id: action.id } : { text: action.text };
+        const command = formatAssertShellLine({
+          assertion,
+          ...target,
+          timeoutSeconds: timeoutMs / 1000
+        });
+        const check2 = describeScreenCheck({ assertion, ...target });
+        const checkStarted = clock.now();
+        const { met } = await withCurrentCommand(setCurrentCommand, command, () => checkScreen({
+          readScreen: () => readScreen2(deps.session),
+          ...target,
+          assertion,
+          timeoutMs,
+          sleep: (ms) => clock.sleep(ms),
+          now: () => clock.now(),
+          isAborted: deps.isAborted,
+          isDeadSession: isDeadSessionError
+        }));
+        const shot2 = await deps.session.screenshot();
+        lastScreenshotUri = shot2.path;
+        if (deps.isAborted()) {
+          return "cancelled";
+        }
+        const outcome = met ? "then" : "else";
+        await deps.appendStep({
+          idx: stepIdx,
+          action: {
+            type: "branch",
+            ...target,
+            assertion,
+            timeoutMs,
+            outcome,
+            reason: action.reason ?? `If ${check2}`,
+            thoughts: "Replaying the saved script without calling the AI agent."
+          },
+          screenshotUri: shot2.path,
+          ok: true,
+          latencyMs: clock.now() - checkStarted,
+          detail: `${check2} \u2192 ${outcome}`,
+          command
+        });
+        stepIdx += 1;
+        const stopped = await replay((met ? action.then : action.else) ?? []);
+        if (stopped)
+          return stopped;
+        continue;
+      }
       const shotStarted = clock.now();
       const shot = await deps.session.screenshot();
       lastScreenshotUri = shot.path;
@@ -105933,6 +107241,32 @@ async function executeScriptCase(deps) {
             command
           });
         });
+      } else if (action.type === "key") {
+        const keyBody = {
+          kind: "key",
+          key: action.key,
+          ...action.modifiers?.length ? { modifiers: action.modifiers } : {}
+        };
+        const command = formatActionShellLine(keyBody);
+        await withCurrentCommand(setCurrentCommand, command, async () => {
+          await perform(deps.session, keyBody);
+          await clock.sleep(settleMs);
+          await deps.appendStep({
+            idx: stepIdx,
+            action: {
+              type: "key",
+              key: action.key,
+              modifiers: action.modifiers,
+              reason: action.reason ?? "Replayed saved script key",
+              thoughts: "Replaying the saved script without calling the AI agent."
+            },
+            screenshotUri: shot.path,
+            ok: true,
+            latencyMs,
+            detail: action.reason ?? null,
+            command
+          });
+        });
       } else if (action.type === "type") {
         const typeBody = { kind: "input", text: action.text };
         const command = formatActionShellLine(typeBody);
@@ -106048,6 +107382,13 @@ async function executeScriptCase(deps) {
       }
       stepIdx += 1;
     }
+    return null;
+  };
+  try {
+    const stopped = await replay(deps.script.actions);
+    if (stopped) {
+      return stopped;
+    }
     await deps.appendStep({
       idx: stepIdx,
       action: {
@@ -106635,12 +107976,12 @@ function reportedLaneWarning(warning) {
 
 // src/domains/runs/run-recording.ts
 import { existsSync as existsSync8 } from "fs";
-import { rm as rm7 } from "fs/promises";
-import { homedir as homedir11 } from "os";
-import { join as join21 } from "path";
-var RUN_VIDEO_DIR = join21(homedir11(), ".yoqa", "runs", "videos");
+import { rm as rm8 } from "fs/promises";
+import { homedir as homedir12 } from "os";
+import { join as join23 } from "path";
+var RUN_VIDEO_DIR = join23(homedir12(), ".yoqa", "runs", "videos");
 function runVideoPath(runTestId, dir = RUN_VIDEO_DIR) {
-  return join21(dir, `${runTestId}.mp4`);
+  return join23(dir, `${runTestId}.mp4`);
 }
 var STOP_TIMEOUT_MS = 20000;
 function errorMessage7(error40) {
@@ -106648,7 +107989,9 @@ function errorMessage7(error40) {
 }
 async function startRunRecording(session, path) {
   if (!session.startRecording) {
-    return { unavailable: `The ${session.lane} lane cannot record video` };
+    return {
+      unavailable: session.noRecordingReason ?? `The ${session.lane} lane cannot record video`
+    };
   }
   let recording;
   try {
@@ -106682,7 +108025,7 @@ async function startRunRecording(session, path) {
   };
 }
 async function deleteRunVideo(runTestId, dir = RUN_VIDEO_DIR) {
-  await rm7(runVideoPath(runTestId, dir), { force: true }).catch(() => {
+  await rm8(runVideoPath(runTestId, dir), { force: true }).catch(() => {
     return;
   });
 }
@@ -106780,6 +108123,10 @@ function parseRunExecutionMode(value) {
 function parseRunScreenMode(value) {
   return value === "vision" ? "vision" : "tree";
 }
+function viewportOf(value) {
+  const parsed = viewportPresetSchema.safeParse(value);
+  return parsed.success ? { viewport: parsed.data } : {};
+}
 function resolveCaseExecutionMode(runMode, hasScript) {
   if (runMode === "agent")
     return "agent";
@@ -106838,6 +108185,8 @@ async function loadRun(runId) {
     screenMode: parseRunScreenMode(runRow.screenMode),
     lane: reportedLane(runRow.lane),
     laneWarning: reportedLaneWarning(runRow.laneWarning),
+    ...runRow.browser ? { browser: runRow.browser } : {},
+    ...viewportOf(runRow.viewport),
     error: runRow.error,
     createdAt: runRow.createdAt,
     startedAt: runRow.startedAt,
@@ -107010,6 +108359,17 @@ async function executeCase(input) {
 async function saveCaseRecording(runTestId, state) {
   await getCatalogDb().update(runTests).set({ recordingStatus: state.status, recordingNote: state.note ?? null }).where(eq(runTests.id, runTestId));
 }
+async function openStartTarget(session, platform, startTarget) {
+  switch (platform) {
+    case "ios":
+    case "android":
+      return;
+    case "web":
+      if (startTarget)
+        await session.openUrl(startTarget);
+      return;
+  }
+}
 async function executeRun(runId) {
   const db = getCatalogDb();
   const run = await loadRun(runId);
@@ -107034,6 +108394,10 @@ async function executeRun(runId) {
     if (!app) {
       throw new RunValidationError("App not found");
     }
+    const startTarget = appStartTarget(app, run.platform);
+    if (run.platform === "web" && !startTarget) {
+      throw new RunValidationError(`${app.name} has no Web URL, so a Run on web has nothing to open. Set one with: yoqa apps update ${app.prefix} --web-url <url>`);
+    }
     const caseModes = [];
     for (const test of run.tests) {
       const catalogCase = await getCase(test.caseId);
@@ -107064,8 +108428,7 @@ async function executeRun(runId) {
       runId,
       deviceId: run.deviceId,
       platform: run.platform,
-      bundleId: app.iosBundleId || undefined,
-      appPackage: app.androidApplicationId || undefined,
+      ...startTargetRequest(run.platform, startTarget),
       requestedLane: requestedLane === "direct" || requestedLane === "auto" ? requestedLane : undefined
     });
     const activeSession = acquired.session;
@@ -107073,8 +108436,11 @@ async function executeRun(runId) {
     sharedSession = acquired.shared;
     await db.update(runs).set({
       lane: session.lane,
-      laneWarning: session.laneWarning ?? null
+      laneWarning: session.laneWarning ?? null,
+      browser: session.browser ?? null,
+      viewport: session.viewport ?? null
     }).where(eq(runs.id, runId));
+    await openStartTarget(session, run.platform, startTarget);
     if (isAborted2(runId)) {
       await persistCancelled(runId);
       return;
@@ -107109,7 +108475,7 @@ async function executeRun(runId) {
         auth,
         caseMode,
         screenMode: run.screenMode ?? "tree",
-        defaultAppId: run.platform === "ios" ? app.iosBundleId || undefined : app.androidApplicationId || undefined
+        defaultAppId: startTarget
       }));
       if (!await loadRun(runId))
         await deleteRunVideo(test.id);
@@ -107296,6 +108662,8 @@ async function listRuns(appId) {
     screenMode: parseRunScreenMode(runRow.screenMode),
     lane: reportedLane(runRow.lane),
     laneWarning: reportedLaneWarning(runRow.laneWarning),
+    ...runRow.browser ? { browser: runRow.browser } : {},
+    ...viewportOf(runRow.viewport),
     error: runRow.error,
     createdAt: runRow.createdAt,
     startedAt: runRow.startedAt,
@@ -109347,7 +110715,7 @@ function createDevicesRoutes() {
     const platformParam = c.req.query("platform");
     const parsedPlatform = devicePlatformSchema.safeParse(platformParam);
     if (!parsedPlatform.success) {
-      return c.json({ error: "Query param platform is required and must be 'ios' or 'android'" }, 400);
+      return c.json({ error: "Query param platform is required and must be 'ios', 'android' or 'web'" }, 400);
     }
     const includeUnavailable = c.req.query("all") !== "0";
     const platform = parsedPlatform.data;
@@ -109362,12 +110730,12 @@ function createDevicesRoutes() {
 }
 
 // src/domains/doctor/application.ts
-import { homedir as homedir12 } from "os";
-import { join as join22 } from "path";
+import { homedir as homedir13 } from "os";
+import { join as join24 } from "path";
 // package.json
 var package_default = {
   name: "@yoqa/runner",
-  version: "1.0.0",
+  version: "1.0.3",
   description: "Yoqa local runner \u2014 device control + catalog HTTP API (Bun). Start with yoqa serve or the yoqa-runner bin.",
   license: "UNLICENSED",
   type: "module",
@@ -109566,7 +110934,7 @@ async function probeJava() {
   let detail = javaBin ?? "java not on PATH";
   if (javaHome)
     detail = `JAVA_HOME=${javaHome}`;
-  else if (await Bun.file(join22(studioJbr, "bin/java")).exists()) {
+  else if (await Bun.file(join24(studioJbr, "bin/java")).exists()) {
     detail = `Android Studio JBR available at ${studioJbr} (JAVA_HOME unset)`;
   }
   const ok = Boolean(javaBin || javaHome);
@@ -109597,7 +110965,7 @@ async function probeXcodeSelect() {
   };
 }
 async function probeAdbDevices() {
-  const adb = await which2("adb") ?? join22(homedir12(), "Library/Android/sdk/platform-tools/adb");
+  const adb = await which2("adb") ?? join24(homedir13(), "Library/Android/sdk/platform-tools/adb");
   if (!await Bun.file(adb).exists() && !await which2("adb")) {
     return {
       id: "adb-devices",
@@ -110014,7 +111382,7 @@ function createProviderRoutes() {
 }
 
 // src/interfaces/http/runs.ts
-import { readFile as readFile5 } from "fs/promises";
+import { readFile as readFile6 } from "fs/promises";
 function parseByteRange(header, size) {
   const match2 = header?.match(/^bytes=(\d*)-(\d*)$/);
   if (!match2)
@@ -110168,7 +111536,7 @@ function createRunsRoutes() {
     const stepId = c.req.param("stepId");
     try {
       const path = await getRunStepScreenshotPath(runId, stepId);
-      const bytes = await readFile5(path);
+      const bytes = await readFile6(path);
       return new Response(bytes, {
         status: 200,
         headers: {
@@ -110231,17 +111599,17 @@ function createServersRoutes() {
 }
 
 // src/interfaces/http/session.ts
-import { mkdir as mkdir7, rename as rename2 } from "fs/promises";
+import { mkdir as mkdir8, rename as rename2 } from "fs/promises";
 import { dirname as dirname7 } from "path";
 
 // src/domains/devices/action-result.ts
-import { mkdir as mkdir6 } from "fs/promises";
-import { join as join24 } from "path";
+import { mkdir as mkdir7 } from "fs/promises";
+import { join as join26 } from "path";
 
 // src/domains/devices/agent-image.ts
-import { mkdtemp as mkdtemp6, readFile as readFile6, rm as rm8, writeFile as writeFile5 } from "fs/promises";
-import { tmpdir as tmpdir7 } from "os";
-import { join as join23 } from "path";
+import { mkdtemp as mkdtemp7, readFile as readFile7, rm as rm9, writeFile as writeFile5 } from "fs/promises";
+import { tmpdir as tmpdir8 } from "os";
+import { join as join25 } from "path";
 var DEFAULT_AGENT_IMAGE_EDGE = 1000;
 function targetEdge(pngBase64, options) {
   if (options.full || options.scale === 1)
@@ -110260,9 +111628,9 @@ async function prepareAgentImage(pngBase64, options = {}) {
   if (bytes.byteLength === 0 || edge == null || process.platform !== "darwin") {
     return { base64: pngBase64, mediaType: "image/png", downscaled: false };
   }
-  const dir = await mkdtemp6(join23(tmpdir7(), "yoqa-agent-image-"));
-  const inPath = join23(dir, "shot.png");
-  const outPath = join23(dir, "shot.jpg");
+  const dir = await mkdtemp7(join25(tmpdir8(), "yoqa-agent-image-"));
+  const inPath = join25(dir, "shot.png");
+  const outPath = join25(dir, "shot.jpg");
   try {
     await writeFile5(inPath, new Uint8Array(bytes));
     const proc = Bun.spawn([
@@ -110282,7 +111650,7 @@ async function prepareAgentImage(pngBase64, options = {}) {
     if (await proc.exited !== 0) {
       return { base64: pngBase64, mediaType: "image/png", downscaled: false };
     }
-    const jpeg = await readFile6(outPath);
+    const jpeg = await readFile7(outPath);
     if (jpeg.byteLength === 0 || jpeg.byteLength >= bytes.byteLength) {
       return { base64: pngBase64, mediaType: "image/png", downscaled: false };
     }
@@ -110290,7 +111658,7 @@ async function prepareAgentImage(pngBase64, options = {}) {
   } catch {
     return { base64: pngBase64, mediaType: "image/png", downscaled: false };
   } finally {
-    await rm8(dir, { recursive: true, force: true }).catch(() => {
+    await rm9(dir, { recursive: true, force: true }).catch(() => {
       return;
     });
   }
@@ -110351,8 +111719,8 @@ function actionMarks(body, resolved) {
   return [];
 }
 async function writeImage(dir, base643, label, ext) {
-  await mkdir6(dir, { recursive: true });
-  const path = join24(dir, `${label}_${Date.now()}_${crypto.randomUUID()}.${ext}`);
+  await mkdir7(dir, { recursive: true });
+  const path = join26(dir, `${label}_${Date.now()}_${crypto.randomUUID()}.${ext}`);
   await Bun.write(path, Uint8Array.from(Buffer.from(base643, "base64")));
   return path;
 }
@@ -110523,6 +111891,9 @@ function createSessionRoutes() {
     }
     const parsed = connectDeviceRequestSchema.safeParse(json3);
     if (!parsed.success) {
+      if (parsed.error.issues.some((issue2) => issue2.path[0] === "viewport")) {
+        return c.json({ error: `viewport must be ${VIEWPORT_PRESET_NAMES.join(" or ")}` }, 400);
+      }
       return c.json({ error: "Body must include deviceId and platform" }, 400);
     }
     try {
@@ -110617,7 +111988,7 @@ function createSessionRoutes() {
       const shot = await session.screenshot();
       let path = shot.path;
       if (parsed.data.path) {
-        await mkdir7(dirname7(parsed.data.path), { recursive: true });
+        await mkdir8(dirname7(parsed.data.path), { recursive: true });
         await rename2(shot.path, parsed.data.path);
         path = parsed.data.path;
       }
@@ -110762,6 +112133,9 @@ function createSessionRoutes() {
       if (error40 instanceof ActionNotFoundError) {
         return c.json({ error: error40.message }, 404);
       }
+      if (error40 instanceof ActionUnsupportedError) {
+        return c.json({ error: "Action not supported", detail: error40.message }, 422);
+      }
       const message = error40 instanceof Error ? error40.message : String(error40);
       return c.json({ error: "Action failed", detail: message }, 500);
     }