@yoqa/cli 1.0.2 → 1.0.4

package/dist/main.js

@@ -13045,13 +13045,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),
@@ -13191,13 +13198,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(),
@@ -13207,6 +13216,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({
@@ -13255,6 +13265,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),
@@ -13262,60 +13291,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(),
@@ -13626,6 +13694,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(),
@@ -13644,7 +13714,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"),
@@ -13662,7 +13733,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(),
@@ -13708,7 +13780,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,
@@ -13726,6 +13799,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(),
@@ -13883,109 +13958,71 @@ function pickLatestRun(runs) {
   return runs.reduce((best, run) => run.createdAt > best.createdAt ? run : best);
 }
 
-// ../runner-client/src/script-format.ts
-function shellSingleQuote(value) {
-  return `'${value.replace(/'/g, `'\\''`)}'`;
-}
-function actionToShellLine(action) {
-  if (action.type === "tap") {
-    const parts = ["yoqa", "action", "tap"];
-    if (action.label) {
-      parts.push("--label", shellSingleQuote(action.label));
-    } else if (action.id) {
-      parts.push("--id", shellSingleQuote(action.id));
-    } else {
-      parts.push("--x", String(Math.round(action.x ?? 0)), "--y", String(Math.round(action.y ?? 0)));
-    }
-    if (action.double)
-      parts.push("--double");
-    if (action.durationMs != null)
-      parts.push("--duration", String(Math.round(action.durationMs)));
-    return parts.join(" ");
-  }
-  if (action.type === "swipe") {
-    const parts = [
-      "yoqa",
-      "action",
-      "swipe",
-      "--x",
-      String(Math.round(action.x)),
-      "--y",
-      String(Math.round(action.y)),
-      "--x2",
-      String(Math.round(action.x2)),
-      "--y2",
-      String(Math.round(action.y2))
-    ];
-    if (action.durationMs != null) {
-      parts.push("--duration", String(Math.round(action.durationMs)));
-    }
-    return parts.join(" ");
-  }
-  if (action.type === "drag") {
-    const parts = [
-      "yoqa",
-      "action",
-      "drag",
-      "--x",
-      String(Math.round(action.x)),
-      "--y",
-      String(Math.round(action.y)),
-      "--x2",
-      String(Math.round(action.x2)),
-      "--y2",
-      String(Math.round(action.y2))
-    ];
-    if (action.durationMs != null) {
-      parts.push("--duration", String(Math.round(action.durationMs)));
-    }
-    return parts.join(" ");
-  }
-  if (action.type === "type") {
-    return `yoqa action input --text ${shellSingleQuote(action.text)}`;
-  }
-  if (action.type === "assert") {
-    const timeoutSeconds = action.timeoutMs != null ? Math.max(1, Math.round(action.timeoutMs / 1000)) : undefined;
-    const parts = ["yoqa", "assert", action.assertion, "--text", shellSingleQuote(action.text)];
-    if (timeoutSeconds != null) {
-      parts.push("--timeout", String(timeoutSeconds));
-    }
-    return parts.join(" ");
-  }
-  if (action.type === "alert") {
-    return action.alertAction === "dismiss" ? "yoqa action alert --dismiss" : "yoqa action alert";
-  }
-  if (action.type === "activate-app" || action.type === "terminate-app" || action.type === "restart-app") {
-    return `yoqa action ${action.type} --app-id ${shellSingleQuote(action.appId)}`;
-  }
-  if (action.type === "background-app") {
-    return action.seconds != null ? `yoqa action background-app --seconds ${action.seconds}` : "yoqa action background-app";
-  }
-  if (action.type === "open-url") {
-    return `yoqa action open-url --url ${shellSingleQuote(action.url)}`;
+// ../../node_modules/yaml/dist/index.js
+var composer = require_composer();
+var Document = require_Document();
+var Schema = 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 = Schema.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;
+
+// ../runner-client/src/keys.ts
+function byName(names, raw, what) {
+  const match = names.find((name) => name.toLowerCase() === raw.trim().toLowerCase());
+  if (!match) {
+    throw new Error(`Unknown ${what} "${raw}" (expected one of: ${names.join(", ")})`);
   }
-  const seconds = Math.max(0.1, action.ms / 1000);
-  return `sleep ${seconds}`;
+  return match;
 }
-function formatCaseScriptShell(script, meta = {}) {
-  const titleParts = [
-    meta.caseNumber != null ? `#${meta.caseNumber}` : null,
-    meta.caseName?.trim() || null
-  ].filter(Boolean);
-  const title = titleParts.length > 0 ? titleParts.join(" ") : "exported script";
-  const lines = [
-    "#!/usr/bin/env bash",
-    `# Yoqa exported script — ${title}`,
-    "# Requires an active device session: yoqa devices connect <id>",
-    "# Prefer the Case Script file: `yoqa script run <file.yoqa.yaml>`.",
-    "set -euo pipefail",
-    "",
-    ...script.actions.map(actionToShellLine),
-    ""
-  ];
-  return lines.join(`
-`);
+function parseKeyName(raw) {
+  return byName(KEY_NAMES, raw, "key");
+}
+function parseKeyModifiers(raw) {
+  const names = raw.split(",").map((part) => part.trim()).filter(Boolean);
+  return [...new Set(names.map((name) => byName(KEY_MODIFIERS, name, "modifier")))];
+}
+function formatKeyChord(key, modifiers = []) {
+  return [...modifiers, key].join("+");
 }
+
 // ../runner-client/src/xml-entities.ts
 var NAMED = {
   amp: "&",
@@ -14012,303 +14049,66 @@ function decodeXmlEntities(value) {
 }
 
 // ../runner-client/src/shell-script.ts
-function shellSingleQuote2(value) {
+function shellSingleQuote(value) {
   return `'${value.replace(/'/g, `'\\''`)}'`;
 }
-function tokenizeShellLine(line) {
-  const tokens = [];
-  let current = "";
-  let quote = null;
-  for (let i = 0;i < line.length; i++) {
-    const ch = line[i];
-    if (ch == null)
-      continue;
-    if (quote === "'") {
-      if (ch === "'") {
-        quote = null;
-      } else {
-        current += ch;
-      }
-      continue;
-    }
-    if (quote === '"') {
-      if (ch === "\\") {
-        const next = line[i + 1];
-        if (next != null) {
-          current += next;
-          i++;
-        }
-        continue;
-      }
-      if (ch === '"') {
-        quote = null;
-      } else {
-        current += ch;
-      }
-      continue;
-    }
-    if (ch === "'" || ch === '"') {
-      quote = ch;
-      continue;
-    }
-    if (/\s/.test(ch)) {
-      if (current.length > 0) {
-        tokens.push(current);
-        current = "";
-      }
-      continue;
-    }
-    current += ch;
-  }
-  if (quote != null) {
-    throw new Error("Unclosed quote");
+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));
   }
-  if (current.length > 0) {
-    tokens.push(current);
+  if (action.label) {
+    parts.push("--label", shellSingleQuote(action.label));
   }
-  return tokens;
-}
-function parseFlagMap(tokens) {
-  const flags = new Map;
-  for (let i = 0;i < tokens.length; i++) {
-    const token = tokens[i];
-    if (token == null || !token.startsWith("-"))
-      continue;
-    const eq = token.indexOf("=");
-    if (eq > 0) {
-      flags.set(token.slice(0, eq), token.slice(eq + 1));
-      continue;
-    }
-    const next = tokens[i + 1];
-    if (next != null && !next.startsWith("-")) {
-      flags.set(token, next);
-      i++;
-    } else {
-      flags.set(token, true);
-    }
+  if (action.description) {
+    parts.push("-d", shellSingleQuote(action.description));
   }
-  return flags;
-}
-function flagString(flags, ...names) {
-  for (const name of names) {
-    const value = flags.get(name);
-    if (typeof value === "string")
-      return value;
+  if (action.x != null)
+    parts.push("--x", String(Math.round(action.x)));
+  if (action.y != null)
+    parts.push("--y", String(Math.round(action.y)));
+  if (action.x2 != null)
+    parts.push("--x2", String(Math.round(action.x2)));
+  if (action.y2 != null)
+    parts.push("--y2", String(Math.round(action.y2)));
+  if (action.durationMs != null)
+    parts.push("--duration", String(Math.round(action.durationMs)));
+  if (action.double)
+    parts.push("--double");
+  if (action.text != null)
+    parts.push("--text", shellSingleQuote(action.text));
+  if (action.appId != null)
+    parts.push("--app-id", shellSingleQuote(action.appId));
+  if (action.url != null)
+    parts.push("--url", shellSingleQuote(action.url));
+  if (action.seconds != null)
+    parts.push("--seconds", String(action.seconds));
+  if (action.kind === "alert") {
+    if (action.alertAction === "dismiss")
+      parts.push("--dismiss");
   }
-  return;
+  return parts.join(" ");
 }
-function flagNumber(flags, ...names) {
-  const raw = flagString(flags, ...names);
-  if (raw == null)
-    return;
-  const n = Number(raw);
-  return Number.isFinite(n) ? n : undefined;
+function formatSleepShellLine(seconds) {
+  const safe = Math.max(0, seconds);
+  const rounded = Number.isInteger(safe) ? String(safe) : String(Number(safe.toFixed(3)));
+  return `sleep ${rounded}`;
 }
-function parseActionFromTokens(tokens, lineNumber, raw) {
-  if (tokens[0] !== "yoqa" || tokens[1] !== "action") {
-    throw new Error("Expected `yoqa action <kind> …`");
-  }
-  const kindRaw = tokens[2];
-  if (!kindRaw) {
-    throw new Error("Missing action kind");
-  }
-  const kindParsed = actionKindSchema.safeParse(kindRaw);
-  if (!kindParsed.success) {
-    throw new Error(`Unknown action kind: ${kindRaw}`);
-  }
-  const kind = kindParsed.data;
-  const flags = parseFlagMap(tokens.slice(3));
-  const action = { kind };
-  const description = flagString(flags, "-d", "--description");
-  if (description != null)
-    action.description = description;
-  const label = flagString(flags, "--label");
-  if (label != null)
-    action.label = label;
-  const id = flagString(flags, "--id");
-  if (id != null)
-    action.id = id;
-  const x = flagNumber(flags, "--x");
-  const y = flagNumber(flags, "--y");
-  const x2 = flagNumber(flags, "--x2");
-  const y2 = flagNumber(flags, "--y2");
-  const durationMs = flagNumber(flags, "--duration");
-  const text = flagString(flags, "--text");
-  const appId = flagString(flags, "--app-id", "--bundle-id");
-  const url = flagString(flags, "--url");
-  const seconds = flagNumber(flags, "--seconds");
-  if (x != null)
-    action.x = x;
-  if (y != null)
-    action.y = y;
-  if (x2 != null)
-    action.x2 = x2;
-  if (y2 != null)
-    action.y2 = y2;
-  if (durationMs != null)
-    action.durationMs = durationMs;
-  if (text != null)
-    action.text = text;
-  if (appId != null)
-    action.appId = appId;
-  if (url != null)
-    action.url = url;
-  if (seconds != null)
-    action.seconds = seconds;
-  if (flags.has("--double"))
-    action.double = true;
-  if (flags.has("--dismiss")) {
-    action.alertAction = "dismiss";
-  } else if (flags.has("--accept") || kind === "alert") {
-    const alertAction = flagString(flags, "--action");
-    if (alertAction === "dismiss")
-      action.alertAction = "dismiss";
-    else if (alertAction === "accept" || kind === "alert")
-      action.alertAction = "accept";
-  }
-  return { kind: "action", action, lineNumber, raw };
+function assertTargetFlags(target) {
+  return [
+    ...target.text != null ? ["--text", shellSingleQuote(target.text.trim())] : [],
+    ...target.id != null ? ["--id", shellSingleQuote(target.id.trim())] : []
+  ];
 }
-function parseScreenshotFromTokens(tokens, lineNumber, raw) {
-  if (tokens[0] !== "yoqa" || tokens[1] !== "screenshot") {
-    throw new Error("Expected `yoqa screenshot [path]`");
-  }
-  const pathToken = tokens[2];
-  if (pathToken?.startsWith("-")) {
-    throw new Error("`yoqa screenshot` accepts an optional output path only");
-  }
-  if (tokens.length > 3) {
-    throw new Error("`yoqa screenshot` accepts at most one path argument");
-  }
-  const path = pathToken?.trim() ? pathToken.trim() : null;
-  return { kind: "screenshot", path, lineNumber, raw };
-}
-function parseAssertFromTokens(tokens, lineNumber, raw) {
-  if (tokens[0] !== "yoqa" || tokens[1] !== "assert") {
-    throw new Error("Expected `yoqa assert <visible|not-visible> …`");
-  }
-  const assertionRaw = tokens[2];
-  if (assertionRaw !== "visible" && assertionRaw !== "not-visible") {
-    throw new Error("Assert kind must be `visible` or `not-visible`");
-  }
-  const flags = parseFlagMap(tokens.slice(3));
-  const text = flagString(flags, "--text", "-t");
-  if (!text || text.trim().length === 0) {
-    throw new Error("assert requires --text");
-  }
-  const timeout = flagNumber(flags, "--timeout") ?? 5;
-  if (timeout < 0) {
-    throw new Error("--timeout must be non-negative");
-  }
-  return {
-    kind: "assert",
-    assertion: assertionRaw,
-    text: text.trim(),
-    timeoutSeconds: timeout,
-    lineNumber,
-    raw
-  };
-}
-function isIgnorableLine(trimmed) {
-  if (trimmed.length === 0)
-    return true;
-  if (trimmed.startsWith("#"))
-    return true;
-  if (trimmed === "set -euo pipefail" || trimmed === "set -e" || trimmed === "set -eu")
-    return true;
-  return false;
-}
-function parseYoqaShellScript(text) {
-  const lines = text.split(/\r?\n/);
-  const steps = [];
-  const errors2 = [];
-  for (let i = 0;i < lines.length; i++) {
-    const lineNumber = i + 1;
-    const raw = lines[i] ?? "";
-    const trimmed = raw.trim();
-    if (isIgnorableLine(trimmed))
-      continue;
-    try {
-      const tokens = tokenizeShellLine(trimmed);
-      if (tokens.length === 0)
-        continue;
-      if (tokens[0] === "sleep") {
-        const seconds = Number(tokens[1]);
-        if (!Number.isFinite(seconds) || seconds < 0) {
-          throw new Error("`sleep` requires a non-negative number of seconds");
-        }
-        steps.push({ kind: "sleep", seconds, lineNumber, raw: trimmed });
-        continue;
-      }
-      if (tokens[0] === "yoqa" && tokens[1] === "assert") {
-        steps.push(parseAssertFromTokens(tokens, lineNumber, trimmed));
-        continue;
-      }
-      if (tokens[0] === "yoqa" && tokens[1] === "screenshot") {
-        steps.push(parseScreenshotFromTokens(tokens, lineNumber, trimmed));
-        continue;
-      }
-      if (tokens[0] === "yoqa") {
-        steps.push(parseActionFromTokens(tokens, lineNumber, trimmed));
-        continue;
-      }
-      throw new Error(`Unsupported command: ${tokens[0]}`);
-    } catch (error) {
-      errors2.push({
-        lineNumber,
-        raw: trimmed,
-        message: error instanceof Error ? error.message : String(error)
-      });
-    }
-  }
-  return { steps, errors: errors2 };
-}
-function formatActionShellLine(action) {
-  const parts = ["yoqa", "action", action.kind];
-  if (action.id) {
-    parts.push("--id", shellSingleQuote2(action.id));
-  }
-  if (action.label) {
-    parts.push("--label", shellSingleQuote2(action.label));
-  }
-  if (action.description) {
-    parts.push("-d", shellSingleQuote2(action.description));
-  }
-  if (action.x != null)
-    parts.push("--x", String(Math.round(action.x)));
-  if (action.y != null)
-    parts.push("--y", String(Math.round(action.y)));
-  if (action.x2 != null)
-    parts.push("--x2", String(Math.round(action.x2)));
-  if (action.y2 != null)
-    parts.push("--y2", String(Math.round(action.y2)));
-  if (action.durationMs != null)
-    parts.push("--duration", String(Math.round(action.durationMs)));
-  if (action.double)
-    parts.push("--double");
-  if (action.text != null)
-    parts.push("--text", shellSingleQuote2(action.text));
-  if (action.appId != null)
-    parts.push("--app-id", shellSingleQuote2(action.appId));
-  if (action.url != null)
-    parts.push("--url", shellSingleQuote2(action.url));
-  if (action.seconds != null)
-    parts.push("--seconds", String(action.seconds));
-  if (action.kind === "alert") {
-    if (action.alertAction === "dismiss")
-      parts.push("--dismiss");
-  }
-  return parts.join(" ");
-}
-function formatSleepShellLine(seconds) {
-  const safe = Math.max(0, seconds);
-  const rounded = Number.isInteger(safe) ? String(safe) : String(Number(safe.toFixed(3)));
-  return `sleep ${rounded}`;
-}
-function formatAssertShellLine(input) {
-  const parts = ["yoqa", "assert", input.assertion, "--text", shellSingleQuote2(input.text.trim())];
-  const timeout = input.timeoutSeconds ?? 5;
-  if (timeout !== 5) {
-    parts.push("--timeout", String(timeout));
+function formatAssertShellLine(input) {
+  const parts = ["yoqa", "assert", input.assertion, ...assertTargetFlags(input)];
+  const timeout = input.timeoutSeconds ?? 5;
+  if (timeout !== 5) {
+    parts.push("--timeout", String(timeout));
   }
   return parts.join(" ");
 }
@@ -14320,25 +14120,6 @@ var DEFAULT_SHELL_SCRIPT_HEADER = [
   ""
 ].join(`
 `);
-function sleepMs(ms, signal) {
-  if (ms <= 0)
-    return Promise.resolve();
-  return new Promise((resolve, reject) => {
-    if (signal?.aborted) {
-      reject(Object.assign(new Error("Aborted"), { name: "AbortError" }));
-      return;
-    }
-    const timer = setTimeout(() => {
-      signal?.removeEventListener("abort", onAbort);
-      resolve();
-    }, ms);
-    const onAbort = () => {
-      clearTimeout(timer);
-      reject(Object.assign(new Error("Aborted"), { name: "AbortError" }));
-    };
-    signal?.addEventListener("abort", onAbort, { once: true });
-  });
-}
 function normalizedLabel(value) {
   return decodeXmlEntities(value ?? "").trim().toLowerCase();
 }
@@ -14352,1156 +14133,1495 @@ function screenHasText(elements, text) {
     return label.includes(needle) || type.includes(needle);
   });
 }
-async function runAssertStep(client, step, signal) {
-  const deadline = Date.now() + step.timeoutSeconds * 1000;
-  for (;; ) {
-    if (signal?.aborted) {
-      throw Object.assign(new Error("Aborted"), { name: "AbortError" });
-    }
-    const screen = await client.getScreen();
-    const found = screenHasText(screen.elements, step.text);
-    if (step.assertion === "visible" && found)
-      return;
-    if (step.assertion === "not-visible" && !found)
-      return;
-    if (Date.now() >= deadline) {
-      throw new Error(step.assertion === "visible" ? `Expected visible text not found within ${step.timeoutSeconds}s: ${step.text}` : `Unexpected text still visible after ${step.timeoutSeconds}s: ${step.text}`);
-    }
-    await sleepMs(400, signal);
-  }
+function screenHasTarget(elements, target) {
+  if (target.id != null)
+    return findElementById(elements, target.id) != null;
+  return screenHasText(elements, target.text ?? "");
 }
-async function runYoqaShellScript(client, text, options = {}) {
-  const parsed = parseYoqaShellScript(text);
-  if (parsed.errors.length > 0) {
-    const first = parsed.errors[0];
-    if (!first) {
-      return { ok: false, completed: 0, total: parsed.steps.length, error: "Parse error" };
-    }
-    return {
-      ok: false,
-      completed: 0,
-      total: parsed.steps.length,
-      error: `Line ${first.lineNumber}: ${first.message}`
-    };
-  }
-  const { steps } = parsed;
-  const total = steps.length;
-  if (total === 0) {
-    return { ok: true, completed: 0, total: 0 };
+function findElementById(elements, id) {
+  const needle = id.trim().toLowerCase();
+  if (!needle)
+    return null;
+  const list = elements ?? [];
+  const exact = list.filter((el) => (el.id?.trim().toLowerCase() ?? "") === needle);
+  if (exact.length > 0) {
+    exact.sort((a, b) => a.width * a.height - b.width * b.height);
+    return exact[0] ?? null;
+  }
+  const partial = list.filter((el) => {
+    const value = el.id?.toLowerCase() ?? "";
+    return value === needle || value.endsWith(`/${needle}`) || value.endsWith(`:id/${needle}`);
+  });
+  if (partial.length === 0)
+    return null;
+  partial.sort((a, b) => a.width * a.height - b.width * b.height);
+  return partial[0] ?? null;
+}
+
+// ../runner-client/src/case-script-file.ts
+var ACTION_TYPES = Object.keys(caseScriptActionSchemaByType).filter((type) => type !== "branch");
+var BRANCH_KEY = "if";
+var ITEM_NAMES = [...ACTION_TYPES, BRANCH_KEY];
+var BRANCH_FIELDS = ["text", "label", "id", "assertion", "timeoutMs", "then", "else", "reason"];
+var SHORT_FORM_FIELD = {
+  tap: "label",
+  type: "text",
+  wait: "ms",
+  assert: "text",
+  alert: "alertAction",
+  "open-url": "url",
+  "activate-app": "appId",
+  "terminate-app": "appId",
+  "restart-app": "appId",
+  "background-app": "seconds",
+  key: "key"
+};
+var TEXT_SHORT_FORM_FIELDS = new Set(["label", "text", "alertAction", "url", "appId", "key"]);
+var FIELD_ORDER = [
+  "label",
+  "id",
+  "text",
+  "appId",
+  "url",
+  "key",
+  "modifiers",
+  "assertion",
+  "alertAction",
+  "x",
+  "y",
+  "x2",
+  "y2",
+  "ms",
+  "seconds",
+  "timeoutMs",
+  "double",
+  "durationMs",
+  "reason"
+];
+var TOP_LEVEL_KEYS = new Set(["version", "name", "sourceRunId", "savedAt", "actions"]);
+function isActionType(value) {
+  return typeof value === "string" && ACTION_TYPES.includes(value);
+}
+function actionFieldNames(type) {
+  const schema = caseScriptActionSchemaByType[type];
+  const object = schema instanceof exports_external.ZodEffects ? schema.innerType() : schema;
+  return new Set(Object.keys(object.shape).filter((key) => key !== "type"));
+}
+function lineOf(node, lineCounter2) {
+  const start = node?.range?.[0];
+  return start == null ? null : lineCounter2.linePos(start).line;
+}
+function zodMessage(error) {
+  return error.issues.map((issue) => issue.path.length > 0 ? `${issue.path.join(".")}: ${issue.message}` : issue.message).join("; ");
+}
+function readAction(raw, legacy) {
+  if (raw == null || typeof raw !== "object" || Array.isArray(raw)) {
+    return { ok: false, message: "expected an action such as `- tap: Home`" };
   }
-  for (let index = 0;index < steps.length; index++) {
-    if (options.signal?.aborted) {
-      return { ok: false, completed: index, total, error: "Aborted" };
+  const entries = Object.entries(raw);
+  let type;
+  let fields;
+  if (legacy) {
+    const declared = raw.type;
+    if (!isActionType(declared)) {
+      return { ok: false, message: `unknown action type ${JSON.stringify(declared)}` };
     }
-    const step = steps[index];
-    if (!step)
-      continue;
-    await options.onStep?.({ index, total, step, status: "running" });
-    try {
-      if (step.kind === "sleep") {
-        await sleepMs(step.seconds * 1000, options.signal);
-      } else if (step.kind === "assert") {
-        await runAssertStep(client, step, options.signal);
-      } else if (step.kind === "screenshot") {
-        await client.takeScreenshot(step.path ? { path: step.path } : {});
-      } else {
-        await client.performAction(step.action);
-        if (options.pauseAfterActionMs) {
-          await sleepMs(options.pauseAfterActionMs, options.signal);
-        }
-      }
-      await options.onStep?.({ index, total, step, status: "ok" });
-    } catch (error) {
-      const message = error instanceof Error ? error.message : String(error);
-      await options.onStep?.({ index, total, step, status: "error", error: message });
+    type = declared;
+    fields = Object.fromEntries(entries.filter(([key]) => key !== "type"));
+  } else {
+    if (entries.length !== 1) {
+      return {
+        ok: false,
+        message: `an action has exactly one key (its name); found ${entries.map(([key2]) => key2).join(", ") || "none"}`
+      };
+    }
+    const [key, value] = entries[0];
+    if (!isActionType(key)) {
       return {
         ok: false,
-        completed: index,
-        total,
-        error: `Line ${step.lineNumber}: ${message}`
+        message: `unknown action "${key}" (expected one of: ${ITEM_NAMES.join(", ")})`
+      };
+    }
+    type = key;
+    if (value == null) {
+      fields = {};
+    } else if (typeof value === "object" && !Array.isArray(value)) {
+      fields = value;
+    } else if (Array.isArray(value)) {
+      return { ok: false, message: `${type}: expected a value or a map of fields, not a list` };
+    } else {
+      const field = SHORT_FORM_FIELD[type];
+      if (!field) {
+        return { ok: false, message: `${type} has no short form; write it as a map of fields` };
+      }
+      fields = {
+        [field]: TEXT_SHORT_FORM_FIELDS.has(field) && typeof value !== "string" ? String(value) : value
       };
     }
   }
-  return { ok: true, completed: total, total };
+  const allowed = actionFieldNames(type);
+  const unknown = Object.keys(fields).filter((key) => !allowed.has(key));
+  if (unknown.length > 0) {
+    return {
+      ok: false,
+      message: `${type}: unknown field ${unknown.map((key) => `"${key}"`).join(", ")} (allowed: ${[...allowed].join(", ")})`
+    };
+  }
+  const parsed = caseScriptActionSchemaByType[type].safeParse({ type, ...fields });
+  if (!parsed.success) {
+    return { ok: false, message: `${type}: ${zodMessage(parsed.error)}` };
+  }
+  return { ok: true, action: parsed.data };
 }
-
-// ../runner-client/src/run-report.ts
-function readStepCycle(action) {
-  if (!action || typeof action !== "object" || !("cycle" in action))
-    return null;
-  const cycle = action.cycle;
-  if (!cycle || typeof cycle !== "object")
+function pushItemError(reader, line, at, message) {
+  reader.errors.push({
+    line,
+    action: at.action,
+    ...at.nested.length > 0 ? { nested: at.nested } : {},
+    message
+  });
+}
+function branchValue(item, legacy) {
+  if (!$isMap(item))
     return null;
-  const record = cycle;
-  const asRecord = (value) => value && typeof value === "object" ? value : null;
-  const verify = asRecord(record.verify);
-  if (!verify || typeof verify.type !== "string" || !verify.type)
+  if (legacy)
+    return item.get("type") === "branch" ? { value: item } : null;
+  const only = item.items.length === 1 ? item.items[0] : undefined;
+  const key = only && $isScalar(only.key) ? only.key.value : null;
+  return key === BRANCH_KEY ? { value: only?.value ?? null } : null;
+}
+function readItem(reader, item, at) {
+  const line = lineOf(item, reader.lineCounter);
+  const branch = branchValue(item, reader.legacy);
+  if (branch)
+    return readBranch(reader, branch.value, line, at);
+  const raw = $isNode(item) ? item.toJS(reader.doc) : item;
+  const result = readAction(raw, reader.legacy);
+  if (result.ok)
+    return result.action;
+  pushItemError(reader, line, at, result.message);
+  return null;
+}
+function readBranch(reader, value, itemLine, at) {
+  const name = reader.legacy ? "branch" : BRANCH_KEY;
+  if (!$isMap(value)) {
+    pushItemError(reader, itemLine, at, `${name} has no short form; write it as a map with \`text:\` and \`then:\``);
     return null;
-  return {
-    action: asRecord(record.action),
-    decision: asRecord(record.decision),
-    verify: {
-      type: verify.type,
-      reason: typeof verify.reason === "string" ? verify.reason : null,
-      thoughts: typeof verify.thoughts === "string" ? verify.thoughts : null
+  }
+  let ok = true;
+  const fail = (line, message) => {
+    pushItemError(reader, line ?? itemLine, at, `${name}: ${message}`);
+    ok = false;
+  };
+  const keyLine = (key) => {
+    const pair = value.items.find((item) => $isScalar(item.key) && item.key.value === key);
+    return lineOf(pair?.key, reader.lineCounter);
+  };
+  const field = (key) => {
+    const node = value.get(key, true);
+    return $isNode(node) ? node.toJS(reader.doc) : node;
+  };
+  const unknown = value.items.map((item) => $isScalar(item.key) ? item.key.value : item.key).filter((key) => !(reader.legacy && key === "type")).filter((key) => typeof key !== "string" || !BRANCH_FIELDS.includes(key));
+  if (unknown.length > 0) {
+    fail(keyLine(String(unknown[0])), `unknown field ${unknown.map((key) => `"${String(key)}"`).join(", ")} (allowed: ${BRANCH_FIELDS.join(", ")})`);
+  }
+  const text = field("text");
+  const label = field("label");
+  const id = field("id");
+  if (text != null && label != null)
+    fail(keyLine("label"), "write `text` or `label`, not both");
+  const textTarget = text ?? label;
+  if (textTarget != null && id != null)
+    fail(keyLine("id"), "write `text` or `id`, not both");
+  if (textTarget == null && id == null) {
+    fail(itemLine, "needs `text:` or `id:` (what to look for on the Screen)");
+  }
+  const readSide = (side) => {
+    const node = value.get(side, true);
+    if (node == null || $isScalar(node) && node.value == null)
+      return;
+    if (!$isSeq(node)) {
+      fail(keyLine(side), `${side} must be a list of actions (each item starts with \`- \`)`);
+      return;
     }
+    const actions = [];
+    node.items.forEach((item, index) => {
+      const action = readItem(reader, item, {
+        action: at.action,
+        nested: [...at.nested, { side, action: index + 1 }]
+      });
+      if (action)
+        actions.push(action);
+      else
+        ok = false;
+    });
+    return actions;
   };
-}
-function summarizeActionRecord(record) {
-  const type = typeof record.type === "string" ? record.type : "step";
-  if (type === "tap") {
-    if (typeof record.label === "string" && record.label.trim())
-      return `Tap: ${record.label}`;
-    if (typeof record.id === "string" && record.id.trim())
-      return `Tap #${record.id}`;
-    return "Tap";
+  const then = readSide("then");
+  if (ok && (then == null || then.length === 0)) {
+    fail(then == null ? itemLine : keyLine("then"), "needs `then:` with at least one action");
   }
-  if (type === "type")
-    return `Type${typeof record.text === "string" ? `: ${record.text}` : ""}`;
-  if (type === "wait")
-    return "Wait";
-  if (type === "alert") {
-    return record.alertAction === "dismiss" ? "Dismiss alert" : "Accept alert";
+  const otherwise = readSide("else");
+  if (!ok)
+    return null;
+  const fields = Object.fromEntries(["assertion", "timeoutMs", "reason"].map((key) => [key, field(key)]).filter(([, fieldValue]) => fieldValue !== undefined));
+  const parsed = caseScriptActionSchemaByType.branch.safeParse({
+    type: "branch",
+    ...id != null ? { id: String(id) } : { text: String(textTarget) },
+    ...fields,
+    then,
+    ...otherwise ? { else: otherwise } : {}
+  });
+  if (!parsed.success) {
+    pushItemError(reader, itemLine, at, `${name}: ${zodMessage(parsed.error)}`);
+    return null;
   }
-  if (type === "assert") {
-    const assertion = typeof record.assertion === "string" ? record.assertion : "visible";
-    const text = typeof record.text === "string" ? record.text : "";
-    return text ? `Assert ${assertion}: ${text}` : `Assert ${assertion}`;
+  const { else: elseActions, ...branch } = parsed.data;
+  return elseActions ? { ...branch, else: elseActions } : branch;
+}
+function documentErrors(doc, lineCounter2) {
+  return doc.errors.map((error) => ({
+    line: lineCounter2.linePos(error.pos[0]).line,
+    action: null,
+    message: error.message
+  }));
+}
+function parseCaseScriptFile(text, options = {}) {
+  const lineCounter2 = new $LineCounter;
+  const doc = $parseDocument(text, { lineCounter: lineCounter2, prettyErrors: false });
+  if (doc.errors.length > 0) {
+    return { ok: false, errors: documentErrors(doc, lineCounter2) };
   }
-  if (type === "verify")
-    return "Verify";
-  if (type === "done")
-    return "Done";
-  if (type === "fail")
-    return "Failed";
-  if (type === "swipe") {
-    if (typeof record.direction === "string" && record.direction.trim()) {
-      return `Swipe ${record.direction}`;
+  const root = doc.contents;
+  if (!$isMap(root)) {
+    return {
+      ok: false,
+      errors: [
+        {
+          line: lineOf(root, lineCounter2) ?? 1,
+          action: null,
+          message: "expected a Case Script with `version: 1` and `actions:`"
+        }
+      ]
+    };
+  }
+  const errors3 = [];
+  const top = root.toJS(doc);
+  for (const pair of root.items) {
+    const key = $isScalar(pair.key) ? pair.key.value : pair.key;
+    if (typeof key !== "string" || !TOP_LEVEL_KEYS.has(key)) {
+      errors3.push({
+        line: lineOf(pair.key, lineCounter2),
+        action: null,
+        message: `unknown key "${String(key)}" (allowed: ${[...TOP_LEVEL_KEYS].join(", ")})`
+      });
     }
-    const x = typeof record.x === "number" ? record.x : null;
-    const y = typeof record.y === "number" ? record.y : null;
-    const x2 = typeof record.x2 === "number" ? record.x2 : null;
-    const y2 = typeof record.y2 === "number" ? record.y2 : null;
-    if (y != null && y2 != null && x != null && x2 != null) {
-      const dy = y2 - y;
-      const dx = x2 - x;
-      if (Math.abs(dy) >= Math.abs(dx)) {
-        if (dy < -50)
-          return "Swipe up";
-        if (dy > 50)
-          return "Swipe down";
-      } else {
-        if (dx < -50)
-          return "Swipe left";
-        if (dx > 50)
-          return "Swipe right";
-      }
+  }
+  const versionNode = root.get("version", true);
+  if (top.version !== 1) {
+    errors3.push({
+      line: lineOf(versionNode, lineCounter2) ?? 1,
+      action: null,
+      message: top.version === undefined ? "missing `version: 1`" : `unsupported version ${JSON.stringify(top.version)} (expected 1)`
+    });
+  }
+  const name = top.name;
+  if (name != null && typeof name !== "string") {
+    errors3.push({
+      line: lineOf(root.get("name", true), lineCounter2),
+      action: null,
+      message: "name must be text"
+    });
+  }
+  const sourceRunId = top.sourceRunId;
+  if (sourceRunId != null && (typeof sourceRunId !== "string" || sourceRunId.length === 0)) {
+    errors3.push({
+      line: lineOf(root.get("sourceRunId", true), lineCounter2),
+      action: null,
+      message: "sourceRunId must be text"
+    });
+  }
+  const savedAt = top.savedAt;
+  const legacy = savedAt !== undefined;
+  if (legacy && (typeof savedAt !== "number" || !Number.isInteger(savedAt) || savedAt < 0)) {
+    errors3.push({
+      line: lineOf(root.get("savedAt", true), lineCounter2),
+      action: null,
+      message: "savedAt must be a non-negative whole number"
+    });
+  }
+  const actionsNode = root.get("actions", true);
+  const actions = [];
+  const actionLines = [];
+  if (actionsNode != null && !($isScalar(actionsNode) && actionsNode.value == null)) {
+    if (!$isSeq(actionsNode)) {
+      errors3.push({
+        line: lineOf(actionsNode, lineCounter2),
+        action: null,
+        message: "actions must be a list (each item starts with `- `)"
+      });
+    } else {
+      const reader = { doc, lineCounter: lineCounter2, legacy, errors: errors3 };
+      actionsNode.items.forEach((item, index) => {
+        const action = readItem(reader, item, { action: index + 1, nested: [] });
+        if (action) {
+          actions.push(action);
+          actionLines.push(lineOf(item, lineCounter2) ?? 0);
+        }
+      });
     }
-    return "Swipe";
+  } else if (!root.has("actions")) {
+    errors3.push({ line: null, action: null, message: "missing `actions:`" });
   }
-  if (type === "input") {
-    return `Input${typeof record.text === "string" ? `: ${record.text}` : ""}`;
+  if (errors3.length === 0 && actions.length === 0 && !options.allowEmpty) {
+    errors3.push({
+      line: lineOf(actionsNode, lineCounter2),
+      action: null,
+      message: "actions: add at least one action"
+    });
   }
-  if (type === "drag")
-    return "Drag";
-  if (type === "activate-app")
-    return "Activate app";
-  if (type === "terminate-app")
-    return "Terminate app";
-  if (type === "restart-app")
-    return "Restart app";
-  if (type === "background-app")
-    return "Background app";
-  if (type === "open-url") {
-    return typeof record.url === "string" && record.url.trim() ? `Open URL: ${record.url}` : "Open URL";
+  if (errors3.length > 0) {
+    return {
+      ok: false,
+      errors: errors3.sort((a, b) => (a.line ?? Number.POSITIVE_INFINITY) - (b.line ?? Number.POSITIVE_INFINITY))
+    };
   }
-  return type.charAt(0).toUpperCase() + type.slice(1);
+  return {
+    ok: true,
+    name: typeof name === "string" && name.trim().length > 0 ? name.trim() : null,
+    actionLines,
+    script: {
+      version: 1,
+      ...typeof sourceRunId === "string" ? { sourceRunId } : {},
+      savedAt: typeof savedAt === "number" ? savedAt : options.savedAt ?? Date.now(),
+      actions
+    }
+  };
 }
-function actionSummary(action) {
-  if (!action || typeof action !== "object")
-    return "Step";
-  const cycle = readStepCycle(action);
-  if (cycle?.action)
-    return summarizeActionRecord(cycle.action);
-  if (cycle?.decision)
-    return summarizeActionRecord(cycle.decision);
-  return summarizeActionRecord(action);
+function formatCaseScriptFileErrors(errors3) {
+  return errors3.map((error) => {
+    const nested = (error.nested ?? []).map((step) => ` → ${step.side} → action ${step.action}`).join("");
+    const where = [
+      error.line != null ? `Line ${error.line}` : null,
+      error.action != null ? `action ${error.action}${nested}` : null
+    ].filter(Boolean).join(", ");
+    return where ? `${where}: ${error.message}` : error.message;
+  }).join(`
+`);
 }
-function optionalTrimmedString(value) {
-  return typeof value === "string" && value.trim() ? value.trim() : undefined;
+var FLOW_OPTIONS = {
+  collectionStyle: "flow",
+  lineWidth: 0,
+  blockQuote: false,
+  flowCollectionPadding: false
+};
+function yamlScalar(value) {
+  if (typeof value === "string" && /[\n\r\t]/.test(value))
+    return JSON.stringify(value);
+  return $stringify([value], FLOW_OPTIONS).trim().slice(1, -1);
 }
-function optionalFiniteNumber(value) {
-  return typeof value === "number" && Number.isFinite(value) ? value : undefined;
+function orderedFields(action) {
+  const fields = Object.entries(action).filter(([key, value]) => key !== "type" && value !== undefined);
+  const meaningful = fields.filter(([key, value]) => !(action.type === "assert" && key === "assertion" && value === "visible") && !(action.type === "alert" && key === "alertAction" && value === "accept"));
+  const rank = (key) => {
+    const at = FIELD_ORDER.indexOf(key);
+    return at < 0 ? FIELD_ORDER.length : at;
+  };
+  return meaningful.sort(([a], [b]) => rank(a) - rank(b));
 }
-function formatStepCommand(action) {
-  if (!action || typeof action !== "object")
-    return null;
-  const record = action;
-  const type = typeof record.type === "string" ? record.type : null;
-  if (type == null || type === "verify" || type === "done" || type === "fail")
-    return null;
-  if (type === "wait") {
-    const ms = optionalFiniteNumber(record.ms) ?? 0;
-    return formatSleepShellLine(ms / 1000);
-  }
-  if (type === "assert") {
-    const text = optionalTrimmedString(record.text);
-    if (!text)
-      return null;
-    const assertion = record.assertion === "not-visible" ? "not-visible" : "visible";
-    const timeoutMs = optionalFiniteNumber(record.timeoutMs);
-    return formatAssertShellLine({
-      assertion,
-      text,
-      ...timeoutMs != null ? { timeoutSeconds: timeoutMs / 1000 } : {}
+function branchFields(branch) {
+  const fields = branch.id != null ? [["id", branch.id]] : [["text", branch.text]];
+  if (branch.assertion === "not-visible")
+    fields.push(["assertion", branch.assertion]);
+  if (branch.timeoutMs != null)
+    fields.push(["timeoutMs", branch.timeoutMs]);
+  if (branch.reason != null)
+    fields.push(["reason", branch.reason]);
+  return fields;
+}
+function formatCaseScriptFileAction(action) {
+  if (action.type === "branch") {
+    const sides = ["then", "else"].flatMap((side) => {
+      const actions = action[side];
+      if (!actions?.length)
+        return [];
+      return `${side}: [${actions.map((inner) => `{ ${formatCaseScriptFileAction(inner)} }`).join(", ")}]`;
     });
+    const body2 = [
+      ...branchFields(action).map(([key, value]) => `${key}: ${yamlScalar(value)}`),
+      ...sides
+    ].join(", ");
+    return `${BRANCH_KEY}: { ${body2} }`;
   }
-  let request = null;
-  if (type === "tap") {
-    request = { kind: "tap" };
-    const label = optionalTrimmedString(record.label);
-    const id = optionalTrimmedString(record.id);
-    const x = optionalFiniteNumber(record.x);
-    const y = optionalFiniteNumber(record.y);
-    const durationMs = optionalFiniteNumber(record.durationMs);
-    if (label)
-      request.label = label;
-    if (id)
-      request.id = id;
-    if (x != null)
-      request.x = x;
-    if (y != null)
-      request.y = y;
-    if (record.double === true)
-      request.double = true;
-    if (durationMs != null)
-      request.durationMs = durationMs;
-  } else if (type === "swipe" || type === "drag") {
-    request = { kind: type };
-    const x = optionalFiniteNumber(record.x);
-    const y = optionalFiniteNumber(record.y);
-    const x2 = optionalFiniteNumber(record.x2);
-    const y2 = optionalFiniteNumber(record.y2);
-    const durationMs = optionalFiniteNumber(record.durationMs);
-    if (x != null)
-      request.x = x;
-    if (y != null)
-      request.y = y;
-    if (x2 != null)
-      request.x2 = x2;
-    if (y2 != null)
-      request.y2 = y2;
-    if (durationMs != null)
-      request.durationMs = durationMs;
-  } else if (type === "type" || type === "input") {
-    request = { kind: "input" };
-    const text = optionalTrimmedString(record.text);
-    if (text)
-      request.text = text;
-  } else if (type === "alert") {
-    request = {
-      kind: "alert",
-      alertAction: record.alertAction === "dismiss" ? "dismiss" : "accept"
-    };
-  } else if (type === "activate-app" || type === "terminate-app" || type === "restart-app") {
-    request = { kind: type };
-    const appId = optionalTrimmedString(record.appId);
-    if (appId)
-      request.appId = appId;
-  } else if (type === "background-app") {
-    request = { kind: "background-app" };
-    const seconds = optionalFiniteNumber(record.seconds);
-    if (seconds != null)
-      request.seconds = seconds;
-  } else if (type === "open-url") {
-    request = { kind: "open-url" };
-    const url = optionalTrimmedString(record.url);
-    if (url)
-      request.url = url;
+  const fields = orderedFields(action);
+  const shortField = SHORT_FORM_FIELD[action.type];
+  if (action.type === "alert" && fields.length === 0) {
+    return `alert: ${action.alertAction}`;
   }
-  return request ? formatActionShellLine(request) : null;
-}
-function stepReasoning(step) {
-  const action = step.action && typeof step.action === "object" ? step.action : null;
-  const reasonFromAction = typeof action?.reason === "string" && action.reason.trim() ? action.reason.trim() : null;
-  const thoughtsFromAction = typeof action?.thoughts === "string" && action.thoughts.trim() ? action.thoughts.trim() : null;
-  const reason = reasonFromAction ?? (step.detail?.trim() ? step.detail.trim() : null);
-  const thoughts = thoughtsFromAction && thoughtsFromAction !== reason ? thoughtsFromAction : null;
-  return { reason, thoughts };
+  const only = fields[0];
+  if (fields.length === 1 && only && only[0] === shortField) {
+    return `${action.type}: ${yamlScalar(only[1])}`;
+  }
+  if (fields.length === 0) {
+    return `${action.type}: {}`;
+  }
+  const body = fields.map(([key, value]) => `${key}: ${yamlScalar(value)}`).join(", ");
+  return `${action.type}: { ${body} }`;
 }
-function toReportStatus(status) {
-  if (status === "passed" || status === "errored" || status === "cancelled")
-    return status;
-  return null;
+function formatCaseScriptFileItemLines(action, indent) {
+  if (action.type !== "branch")
+    return [`${indent}- ${formatCaseScriptFileAction(action)}`];
+  const fieldIndent = `${indent}    `;
+  const lines = [`${indent}- ${BRANCH_KEY}:`];
+  for (const [key, value] of branchFields(action)) {
+    lines.push(`${fieldIndent}${key}: ${yamlScalar(value)}`);
+  }
+  for (const side of ["then", "else"]) {
+    const actions = action[side];
+    if (!actions?.length)
+      continue;
+    lines.push(`${fieldIndent}${side}:`);
+    for (const inner of actions) {
+      lines.push(...formatCaseScriptFileItemLines(inner, `${fieldIndent}  `));
+    }
+  }
+  return lines;
 }
-function formatStepPhases(phases) {
-  const parts = [
-    `capture ${Math.round(phases.captureMs)}ms`,
-    `screen ${Math.round(phases.screenMs)}ms`,
-    `image ${Math.round(phases.prepareMs)}ms`,
-    `decide ${Math.round(phases.decideMs)}ms`,
-    `action ${Math.round(phases.actionMs)}ms`,
-    `settle ${Math.round(phases.settleMs)}ms`
-  ];
-  if (phases.decideRetries > 0) {
-    parts.push(`retries ${phases.decideRetries}`);
+function formatCaseScriptFile(script, options = {}) {
+  const lines = ["version: 1"];
+  const name = options.name?.trim();
+  if (name)
+    lines.push(`name: ${yamlScalar(name)}`);
+  if (script.sourceRunId)
+    lines.push(`sourceRunId: ${yamlScalar(script.sourceRunId)}`);
+  lines.push("actions:");
+  for (const action of script.actions) {
+    lines.push(...formatCaseScriptFileItemLines(action, "  "));
   }
-  const usage = phases.usage ? formatCallUsage(phases.usage) : null;
-  if (usage)
-    parts.push(usage);
-  return parts.join(" · ");
+  return `${lines.join(`
+`)}
+`;
 }
-function formatCallUsage(usage) {
-  const fields = [
-    usage.inputTokens != null ? `in ${usage.inputTokens}` : null,
-    usage.cachedInputTokens != null ? `cached ${usage.cachedInputTokens}` : null,
-    usage.cacheWriteTokens != null ? `cache write ${usage.cacheWriteTokens}` : null,
-    usage.outputTokens != null ? `out ${usage.outputTokens}` : null
-  ].filter((field) => field != null);
-  if (fields.length === 0)
-    return null;
-  const cached = usage.cachedInputTokens ?? 0;
-  const totalInput = (usage.inputTokens ?? 0) + cached + (usage.cacheWriteTokens ?? 0);
-  const share = totalInput > 0 ? ` (${Math.round(cached / totalInput * 100)}% cached)` : "";
-  return `usage ${fields.join(", ")}${share}`;
+
+// ../runner-client/src/screen-check.ts
+var SCREEN_CHECK_POLL_MS = 400;
+var ASSERT_EXIT_CODE = { met: 0, notMet: 1, couldNotCheck: 2 };
+function abortError() {
+  return Object.assign(new Error("Aborted"), { name: "AbortError" });
 }
-function mapCatalogStep(step, screenshotsByStepId) {
-  const { reason, thoughts } = stepReasoning(step);
-  return {
-    id: step.id,
-    index: step.idx + 1,
-    summary: actionSummary(step.action),
-    ok: step.ok,
-    latencyMs: step.latencyMs,
-    phases: step.phases ?? null,
-    detail: step.detail,
-    reason,
-    thoughts,
-    command: step.command ?? formatStepCommand(step.action),
-    screenshotBase64: screenshotsByStepId[step.id] ?? null
-  };
+function describeScreenCheck(check) {
+  return check.id != null ? `${check.assertion} id: ${check.id}` : `${check.assertion}: ${check.text}`;
 }
-function buildRunReportFromCatalogRun(run, meta = {}, screenshotsByStepId = {}) {
-  const status = toReportStatus(run.status);
-  if (!status) {
-    throw new Error(`Cannot export report for live run status: ${run.status}`);
+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);
   }
-  const caseTitles = meta.caseTitles ?? {};
-  const tests = run.tests.map((test) => ({
-    id: test.id,
-    title: caseTitles[test.caseId] ?? test.caseId,
-    status: test.status,
-    executionMode: test.executionMode ?? null,
-    error: test.error,
-    startedAt: test.startedAt,
-    finishedAt: test.finishedAt,
-    steps: (test.steps ?? []).map((step) => mapCatalogStep(step, screenshotsByStepId))
-  }));
-  const primaryTitle = tests[0]?.title ?? "Run";
-  return {
-    id: run.id,
-    source: "catalog",
-    status,
-    title: primaryTitle,
-    appLabel: meta.appLabel ?? null,
-    deviceLabel: meta.deviceLabel ?? null,
-    platform: run.platform,
-    executionMode: run.executionMode,
-    screenMode: run.screenMode ?? null,
-    lane: run.lane ?? null,
-    laneWarning: run.laneWarning ?? null,
-    error: run.error,
-    createdAt: run.createdAt,
-    startedAt: run.startedAt,
-    finishedAt: run.finishedAt,
-    tests
-  };
 }
-function suggestedRunReportBasename(doc) {
-  const shortId = doc.id.replace(/[^a-zA-Z0-9]+/g, "").slice(0, 8) || "run";
-  const raw = ["yoqa-run", shortId, doc.status].join("-").toLowerCase().replace(/[^a-z0-9-]+/g, "-").replace(/-+/g, "-").replace(/^-|-$/g, "");
-  return raw || "yoqa-run-report";
+
+// ../runner-client/src/case-script-replay.ts
+var DEFAULT_ASSERT_TIMEOUT_MS = 5000;
+function abortError2() {
+  return Object.assign(new Error("Aborted"), { name: "AbortError" });
 }
-function escapeHtml(value) {
-  return value.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;").replace(/'/g, "&#39;");
+function realSleep(ms, signal) {
+  if (ms <= 0)
+    return Promise.resolve();
+  return new Promise((resolve, reject) => {
+    if (signal?.aborted) {
+      reject(abortError2());
+      return;
+    }
+    const timer = setTimeout(() => {
+      signal?.removeEventListener("abort", onAbort);
+      resolve();
+    }, ms);
+    const onAbort = () => {
+      clearTimeout(timer);
+      reject(abortError2());
+    };
+    signal?.addEventListener("abort", onAbort, { once: true });
+  });
 }
-function formatWhen(ms) {
-  if (ms == null)
-    return "—";
-  return new Date(ms).toLocaleString();
+function caseScriptActionRequest(action) {
+  switch (action.type) {
+    case "tap": {
+      const request = { kind: "tap" };
+      if (action.label)
+        request.label = action.label;
+      if (action.id)
+        request.id = action.id;
+      if (action.x != null)
+        request.x = action.x;
+      if (action.y != null)
+        request.y = action.y;
+      if (action.double)
+        request.double = true;
+      if (action.durationMs != null)
+        request.durationMs = action.durationMs;
+      return request;
+    }
+    case "swipe":
+    case "drag":
+      return {
+        kind: action.type,
+        x: action.x,
+        y: action.y,
+        x2: action.x2,
+        y2: action.y2,
+        ...action.durationMs != null ? { durationMs: action.durationMs } : {}
+      };
+    case "type":
+      return { kind: "input", text: action.text };
+    case "alert":
+      return { kind: "alert", alertAction: action.alertAction };
+    case "activate-app":
+    case "terminate-app":
+    case "restart-app":
+      return { kind: action.type, appId: action.appId };
+    case "background-app":
+      return {
+        kind: "background-app",
+        ...action.seconds != null ? { seconds: action.seconds } : {}
+      };
+    case "open-url":
+      return { kind: "open-url", url: action.url };
+    case "key":
+      return {
+        kind: "key",
+        key: action.key,
+        ...action.modifiers?.length ? { modifiers: action.modifiers } : {}
+      };
+    case "wait":
+    case "assert":
+    case "branch":
+      return null;
+  }
 }
-function formatDuration(startedAt, finishedAt) {
-  if (startedAt == null || finishedAt == null)
-    return "—";
-  const ms = Math.max(0, finishedAt - startedAt);
-  if (ms < 1000)
-    return `${ms}ms`;
-  const seconds = ms / 1000;
-  if (seconds < 60)
-    return `${seconds.toFixed(1)}s`;
-  const minutes = Math.floor(seconds / 60);
-  const rem = Math.round(seconds % 60);
-  return `${minutes}m ${rem}s`;
+function screenCheckTimeoutSeconds(action) {
+  if (action.type === "branch")
+    return (action.timeoutMs ?? BRANCH_DEFAULT_TIMEOUT_MS) / 1000;
+  if (action.timeoutMs == null)
+    return;
+  return Math.max(1, Math.round(action.timeoutMs / 1000));
 }
-function statusAccent(status) {
-  if (status === "passed") {
-    return { bg: "#dcfce7", fg: "#166534", label: "Passed" };
-  }
-  if (status === "errored") {
-    return { bg: "#fee2e2", fg: "#991b1b", label: "Failed" };
-  }
-  return { bg: "#e5e7eb", fg: "#374151", label: "Cancelled" };
-}
-function pngDataUri(base64) {
-  return `data:image/png;base64,${base64}`;
-}
-function formatRunReportHtml(doc) {
-  const accent = statusAccent(doc.status);
-  const screenRows = [
-    ...doc.screenMode ? [["Screen", doc.screenMode]] : [],
-    ...doc.lane ? [["Lane", doc.lane]] : [],
-    ...doc.laneWarning ? [["Lane warning", doc.laneWarning]] : []
-  ];
-  const metaRows = [
-    ["Status", accent.label],
-    ["Source", doc.source === "catalog" ? "Catalog run" : "Manual Inspector"],
-    ["App", doc.appLabel ?? "—"],
-    ["Device", doc.deviceLabel ?? "—"],
-    ["Platform", doc.platform ?? "—"],
-    ["Mode", doc.executionMode ?? "—"],
-    ...screenRows,
-    ["Started", formatWhen(doc.startedAt ?? doc.createdAt)],
-    ["Finished", formatWhen(doc.finishedAt)],
-    ["Duration", formatDuration(doc.startedAt ?? doc.createdAt, doc.finishedAt)],
-    ["Run ID", doc.id]
-  ];
-  const testsHtml = doc.tests.map((test, testIndex) => {
-    const testAccent = statusAccent(test.status === "passed" || test.status === "errored" || test.status === "cancelled" ? test.status : doc.status);
-    const stepsHtml = test.steps.map((step) => {
-      const stepStatus = step.ok ? "Passed" : "Failed";
-      const stepColor = step.ok ? "#166534" : "#991b1b";
-      const reasonBlock = step.reason ? `<p class="reason">${escapeHtml(step.reason)}</p>` : "";
-      const thoughtsBlock = step.thoughts ? `<details class="thoughts"><summary>AI thoughts</summary><p>${escapeHtml(step.thoughts)}</p></details>` : "";
-      const detailBlock = step.detail && step.detail !== step.reason ? `<p class="detail">${escapeHtml(step.detail)}</p>` : "";
-      const shot = step.screenshotBase64 ? `<img class="shot" alt="Step ${step.index} screenshot" src="${pngDataUri(step.screenshotBase64)}" />` : `<p class="muted">No screenshot</p>`;
-      const latency = step.latencyMs != null ? `<span class="muted">${step.latencyMs}ms</span>` : "";
-      const phases = step.phases ? `<p class="muted phases">Phases: ${escapeHtml(formatStepPhases(step.phases))}</p>` : "";
-      const commandBlock = step.command ? `<pre class="command"><code>${escapeHtml(step.command)}</code></pre>` : "";
-      return `
-<article class="step ${step.ok ? "ok" : "fail"}">
-  <header>
-    <span class="idx">${step.index}</span>
-    <div>
-      <h3>${escapeHtml(step.summary)}</h3>
-      <p class="step-status" style="color:${stepColor}">${stepStatus} ${latency}</p>
-    </div>
-  </header>
-  ${commandBlock}
-  ${phases}
-  ${reasonBlock}
-  ${detailBlock}
-  ${thoughtsBlock}
-  ${shot}
-</article>`;
-    }).join(`
-`);
-    return `
-<section class="test">
-  <h2>
-    <span class="test-num">${testIndex + 1}</span>
-    ${escapeHtml(test.title)}
-    <span class="pill" style="background:${testAccent.bg};color:${testAccent.fg}">${escapeHtml(testAccent.label)}</span>
-  </h2>
-  ${test.error ? `<p class="error">${escapeHtml(test.error)}</p>` : ""}
-  ${test.executionMode ? `<p class="muted">Mode: ${escapeHtml(test.executionMode)}</p>` : ""}
-  <div class="steps">${stepsHtml || `<p class="muted">No steps recorded</p>`}</div>
-</section>`;
-  }).join(`
-`);
-  const metaHtml = metaRows.map(([label, value]) => `<tr><th>${escapeHtml(label)}</th><td>${escapeHtml(value)}</td></tr>`).join(`
-`);
-  return `<!DOCTYPE html>
-<html lang="en">
-<head>
-<meta charset="utf-8" />
-<meta name="viewport" content="width=device-width, initial-scale=1" />
-<title>Yoqa Report — ${escapeHtml(doc.title)} (${escapeHtml(accent.label)})</title>
-<style>
-  :root { color-scheme: light; }
-  body { font-family: ui-sans-serif, system-ui, -apple-system, Segoe UI, Roboto, sans-serif; margin: 0; background: #f8fafc; color: #0f172a; line-height: 1.5; }
-  .wrap { max-width: 52rem; margin: 0 auto; padding: 2rem 1.25rem 4rem; }
-  .banner { border-radius: 1rem; padding: 1.25rem 1.5rem; background: ${accent.bg}; color: ${accent.fg}; margin-bottom: 1.5rem; }
-  .banner h1 { margin: 0 0 0.35rem; font-size: 1.5rem; }
-  .banner p { margin: 0; opacity: 0.9; }
-  table.meta { width: 100%; border-collapse: collapse; background: #fff; border-radius: 0.75rem; overflow: hidden; box-shadow: 0 1px 2px rgb(0 0 0 / 0.06); margin-bottom: 2rem; }
-  table.meta th, table.meta td { text-align: left; padding: 0.65rem 1rem; border-bottom: 1px solid #e2e8f0; font-size: 0.9rem; }
-  table.meta th { width: 8rem; color: #64748b; font-weight: 600; }
-  .error { background: #fee2e2; color: #991b1b; padding: 0.75rem 1rem; border-radius: 0.5rem; }
-  .test { margin-bottom: 2.5rem; }
-  .test h2 { display: flex; flex-wrap: wrap; align-items: center; gap: 0.5rem; font-size: 1.15rem; }
-  .test-num { display: inline-flex; align-items: center; justify-content: center; width: 1.75rem; height: 1.75rem; border-radius: 999px; background: #0f172a; color: #fff; font-size: 0.8rem; }
-  .pill { display: inline-flex; align-items: center; border-radius: 999px; padding: 0.15rem 0.65rem; font-size: 0.75rem; font-weight: 600; }
-  .step { background: #fff; border: 1px solid #e2e8f0; border-radius: 0.75rem; padding: 1rem; margin: 0.75rem 0; }
-  .step.fail { border-color: #fecaca; }
-  .step header { display: flex; gap: 0.75rem; align-items: flex-start; }
-  .step .idx { flex-shrink: 0; width: 1.75rem; height: 1.75rem; border-radius: 999px; background: #e2e8f0; display: inline-flex; align-items: center; justify-content: center; font-size: 0.75rem; font-weight: 700; }
-  .step.ok .idx { background: #bbf7d0; color: #166534; }
-  .step.fail .idx { background: #fecaca; color: #991b1b; }
-  .step h3 { margin: 0; font-size: 1rem; }
-  .step-status { margin: 0.15rem 0 0; font-size: 0.8rem; font-weight: 600; }
-  .command { margin: 0.5rem 0 0; padding: 0.4rem 0.65rem; background: #f1f5f9; border-radius: 0.4rem; font-size: 0.8rem; overflow-x: auto; }
-  .command code { font-family: ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, monospace; }
-  .reason, .detail { margin: 0.5rem 0 0; color: #475569; font-size: 0.9rem; }
-  .thoughts { margin-top: 0.5rem; font-size: 0.85rem; color: #64748b; }
-  .thoughts p { margin: 0.35rem 0 0; white-space: pre-wrap; }
-  .shot { display: block; max-width: 100%; width: min(22rem, 100%); margin-top: 0.75rem; border-radius: 0.75rem; border: 1px solid #e2e8f0; }
-  .muted { color: #94a3b8; font-size: 0.85rem; }
-  footer { margin-top: 2rem; color: #94a3b8; font-size: 0.8rem; }
-  @media print {
-    body { background: #fff; }
-    .shot { max-height: 60vh; object-fit: contain; }
-  }
-</style>
-</head>
-<body>
-  <div class="wrap">
-    <header class="banner">
-      <h1>${escapeHtml(doc.title)}</h1>
-      <p>${escapeHtml(accent.label)} · Yoqa end-to-end report</p>
-    </header>
-    ${doc.error ? `<p class="error">${escapeHtml(doc.error)}</p>` : ""}
-    <table class="meta">${metaHtml}</table>
-    ${testsHtml}
-    <footer>Generated by Yoqa</footer>
-  </div>
-</body>
-</html>
-`;
-}
-function escapeMd(value) {
-  return value.replace(/\|/g, "\\|").replace(/\r?\n/g, " ");
-}
-function formatRunReportMarkdown(doc) {
-  const accent = statusAccent(doc.status);
-  const lines = [
-    `# Yoqa Report — ${doc.title}`,
-    "",
-    `**Status:** ${accent.label}`,
-    "",
-    "| Field | Value |",
-    "| --- | --- |",
-    `| Source | ${doc.source === "catalog" ? "Catalog run" : "Manual Inspector"} |`,
-    `| App | ${escapeMd(doc.appLabel ?? "—")} |`,
-    `| Device | ${escapeMd(doc.deviceLabel ?? "—")} |`,
-    `| Platform | ${escapeMd(doc.platform ?? "—")} |`,
-    `| Mode | ${escapeMd(doc.executionMode ?? "—")} |`,
-    ...doc.screenMode ? [`| Screen | ${escapeMd(doc.screenMode)} |`] : [],
-    ...doc.lane ? [`| Lane | ${escapeMd(doc.lane)} |`] : [],
-    ...doc.laneWarning ? [`| Lane warning | ${escapeMd(doc.laneWarning)} |`] : [],
-    `| Started | ${escapeMd(formatWhen(doc.startedAt ?? doc.createdAt))} |`,
-    `| Finished | ${escapeMd(formatWhen(doc.finishedAt))} |`,
-    `| Duration | ${escapeMd(formatDuration(doc.startedAt ?? doc.createdAt, doc.finishedAt))} |`,
-    `| Run ID | \`${doc.id}\` |`,
-    ""
-  ];
-  if (doc.error) {
-    lines.push(`> **Error:** ${doc.error}`, "");
-  }
-  doc.tests.forEach((test, testIndex) => {
-    const testLabel = test.status === "passed" ? "Passed" : test.status === "errored" ? "Failed" : test.status === "cancelled" ? "Cancelled" : test.status;
-    lines.push(`## ${testIndex + 1}. ${test.title} (${testLabel})`, "");
-    if (test.executionMode)
-      lines.push(`Mode: \`${test.executionMode}\``, "");
-    if (test.error)
-      lines.push(`**Error:** ${test.error}`, "");
-    if (test.steps.length === 0) {
-      lines.push("_No steps recorded_", "");
-      return;
-    }
-    for (const step of test.steps) {
-      lines.push(`### Step ${step.index}: ${step.summary}`);
-      lines.push("");
-      lines.push(`- Result: **${step.ok ? "Passed" : "Failed"}**`);
-      if (step.command)
-        lines.push(`- Command: \`${step.command.replace(/`/g, "'")}\``);
-      if (step.latencyMs != null)
-        lines.push(`- Latency: ${step.latencyMs}ms`);
-      if (step.phases)
-        lines.push(`- Phases: ${formatStepPhases(step.phases)}`);
-      if (step.reason)
-        lines.push(`- Reason: ${step.reason}`);
-      if (step.detail && step.detail !== step.reason)
-        lines.push(`- Detail: ${step.detail}`);
-      if (step.thoughts) {
-        lines.push("", "<details><summary>AI thoughts</summary>", "", step.thoughts, "", "</details>");
-      }
-      if (step.screenshotBase64) {
-        lines.push("", `![Step ${step.index} screenshot](${pngDataUri(step.screenshotBase64)})`);
-      } else {
-        lines.push("", "_No screenshot_");
-      }
-      lines.push("");
-    }
-  });
-  lines.push("---", "", "_Generated by Yoqa_", "");
-  return lines.join(`
-`);
-}
-function formatRunReportGithubSummary(doc) {
-  const accent = statusAccent(doc.status);
-  const passed = doc.tests.filter((test) => test.status === "passed").length;
-  const failed = doc.tests.filter((test) => test.status === "errored").length;
-  const cancelled = doc.tests.filter((test) => test.status === "cancelled").length;
-  const failedSteps = doc.tests.flatMap((test) => test.steps.filter((step) => !step.ok).map((step) => ({ test, step })));
-  const lines = [
-    `## Yoqa Report — ${doc.title}`,
-    "",
-    `**${accent.label}** · ${doc.tests.length} test${doc.tests.length === 1 ? "" : "s"} · ${passed} passed · ${failed} failed · ${cancelled} cancelled`,
-    "",
-    "| Field | Value |",
-    "| --- | --- |",
-    `| App | ${escapeMd(doc.appLabel ?? "—")} |`,
-    `| Device | ${escapeMd(doc.deviceLabel ?? "—")} |`,
-    `| Platform | ${escapeMd(doc.platform ?? "—")} |`,
-    `| Mode | ${escapeMd(doc.executionMode ?? "—")} |`,
-    ...doc.screenMode ? [`| Screen | ${escapeMd(doc.screenMode)} |`] : [],
-    ...doc.lane ? [`| Lane | ${escapeMd(doc.lane)} |`] : [],
-    ...doc.laneWarning ? [`| Lane warning | ${escapeMd(doc.laneWarning)} |`] : [],
-    `| Duration | ${escapeMd(formatDuration(doc.startedAt ?? doc.createdAt, doc.finishedAt))} |`,
-    `| Run ID | \`${doc.id}\` |`,
-    ""
-  ];
-  if (doc.error) {
-    lines.push(`> **Error:** ${doc.error}`, "");
-  }
-  if (doc.tests.length > 0) {
-    lines.push("### Tests", "", "| # | Test | Status | Steps |", "| --- | --- | --- | --- |");
-    doc.tests.forEach((test, testIndex) => {
-      const testLabel = test.status === "passed" ? "Passed" : test.status === "errored" ? "Failed" : test.status === "cancelled" ? "Cancelled" : test.status;
-      lines.push(`| ${testIndex + 1} | ${escapeMd(test.title)} | ${testLabel} | ${test.steps.length} |`);
-    });
-    lines.push("");
-  }
-  if (failedSteps.length > 0) {
-    lines.push("### Failed steps", "");
-    for (const { test, step } of failedSteps) {
-      lines.push(`- **${escapeMd(test.title)}** · step ${step.index}: ${escapeMd(step.summary)}`);
-      if (step.command)
-        lines.push(`  - Command: \`${escapeMd(step.command)}\``);
-      if (step.reason)
-        lines.push(`  - Reason: ${escapeMd(step.reason)}`);
-      if (step.detail && step.detail !== step.reason) {
-        lines.push(`  - Detail: ${escapeMd(step.detail)}`);
-      }
-    }
-    lines.push("");
-  }
-  lines.push("Download the `yoqa-report` artifact for the full HTML report with screenshots.", "");
-  return lines.join(`
-`);
-}
-// ../../node_modules/yaml/dist/index.js
-var composer = require_composer();
-var Document = require_Document();
-var Schema = 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 = Schema.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;
-
-// ../runner-client/src/case-script-file.ts
-var ACTION_TYPES = Object.keys(caseScriptActionSchemaByType);
-var SHORT_FORM_FIELD = {
-  tap: "label",
-  type: "text",
-  wait: "ms",
-  assert: "text",
-  alert: "alertAction",
-  "open-url": "url",
-  "activate-app": "appId",
-  "terminate-app": "appId",
-  "restart-app": "appId",
-  "background-app": "seconds"
-};
-var TEXT_SHORT_FORM_FIELDS = new Set(["label", "text", "alertAction", "url", "appId"]);
-var FIELD_ORDER = [
-  "label",
-  "id",
-  "text",
-  "appId",
-  "url",
-  "assertion",
-  "alertAction",
-  "x",
-  "y",
-  "x2",
-  "y2",
-  "ms",
-  "seconds",
-  "timeoutMs",
-  "double",
-  "durationMs",
-  "reason"
-];
-var TOP_LEVEL_KEYS = new Set(["version", "name", "sourceRunId", "savedAt", "actions"]);
-function isActionType(value) {
-  return typeof value === "string" && ACTION_TYPES.includes(value);
+function caseScriptActionCommand(action) {
+  if (action.type === "wait") {
+    const seconds = action.ms / 1000;
+    return `sleep ${Number.isInteger(seconds) ? seconds : Number(seconds.toFixed(3))}`;
+  }
+  if (action.type === "assert" || action.type === "branch") {
+    const timeoutSeconds = screenCheckTimeoutSeconds(action);
+    const timeout = timeoutSeconds != null ? ` --timeout ${timeoutSeconds}` : "";
+    return ["yoqa", "assert", action.assertion, ...assertTargetFlags(action)].join(" ") + timeout;
+  }
+  const request = caseScriptActionRequest(action);
+  return request ? formatActionShellLine(request) : action.type;
 }
-function actionFieldNames(type) {
-  const schema = caseScriptActionSchemaByType[type];
-  const object = schema instanceof exports_external.ZodEffects ? schema.innerType() : schema;
-  return new Set(Object.keys(object.shape).filter((key) => key !== "type"));
+function formatCaseScriptStepPath(path) {
+  return [
+    `action ${path.index + 1}`,
+    ...path.nested.map((step) => `${step.side} → action ${step.index + 1}`)
+  ].join(" → ");
 }
-function lineOf(node, lineCounter2) {
-  const start = node?.range?.[0];
-  return start == null ? null : lineCounter2.linePos(start).line;
+function formatCaseScriptReplayStep(event) {
+  const { action } = event;
+  const line = action.type === "branch" ? `if ${describeScreenCheck(action)}${event.outcome ? ` → ${event.outcome}` : ""}` : formatCaseScriptFileAction(action);
+  return `${"  ".repeat(event.path.nested.length)}${line}`;
 }
-function zodMessage(error) {
-  return error.issues.map((issue) => issue.path.length > 0 ? `${issue.path.join(".")}: ${issue.message}` : issue.message).join("; ");
+function replayErrorMessage(error, signal) {
+  if (signal?.aborted || error instanceof Error && error.name === "AbortError")
+    return "Aborted";
+  if (error instanceof Error)
+    return error.message;
+  return String(error);
 }
-function readAction(raw, legacy) {
-  if (raw == null || typeof raw !== "object" || Array.isArray(raw)) {
-    return { ok: false, message: "expected an action such as `- tap: Home`" };
-  }
-  const entries = Object.entries(raw);
-  let type;
-  let fields;
-  if (legacy) {
-    const declared = raw.type;
-    if (!isActionType(declared)) {
-      return { ok: false, message: `unknown action type ${JSON.stringify(declared)}` };
-    }
-    type = declared;
-    fields = Object.fromEntries(entries.filter(([key]) => key !== "type"));
-  } else {
-    if (entries.length !== 1) {
-      return {
-        ok: false,
-        message: `an action has exactly one key (its name); found ${entries.map(([key2]) => key2).join(", ") || "none"}`
-      };
-    }
-    const [key, value] = entries[0];
-    if (!isActionType(key)) {
-      return {
-        ok: false,
-        message: `unknown action "${key}" (expected one of: ${ACTION_TYPES.join(", ")})`
-      };
+async function runCaseScript(client, script, options = {}) {
+  const sleep = options.sleep ?? realSleep;
+  const now = options.now ?? Date.now;
+  const pollMs = options.assertPollMs ?? SCREEN_CHECK_POLL_MS;
+  let total = script.actions.length;
+  let completed = 0;
+  let position = 0;
+  const check = async (action, timeoutMs) => checkScreen({
+    readScreen: () => client.getScreen(),
+    text: action.text,
+    id: action.id,
+    assertion: action.assertion,
+    timeoutMs,
+    pollMs,
+    sleep: (ms) => sleep(ms, options.signal),
+    now,
+    isAborted: () => options.signal?.aborted ?? false
+  });
+  const assertText = async (action) => {
+    const timeoutMs = action.timeoutMs ?? options.defaultAssertTimeoutMs ?? DEFAULT_ASSERT_TIMEOUT_MS;
+    const { met } = await check(action, timeoutMs);
+    if (!met)
+      throw new Error(screenCheckMissMessage({ ...action, timeoutMs }));
+  };
+  const emit = (path, stepPosition, action, status, extra = {}) => options.onStep?.({
+    index: path.index,
+    path,
+    position: stepPosition,
+    total,
+    action,
+    status,
+    ...extra
+  });
+  const skipFrom = async (actions, from, at) => {
+    for (let index = from;index < actions.length; index++) {
+      const action = actions[index];
+      if (action)
+        await emit(at(index), position++, action, "skipped");
     }
-    type = key;
-    if (value == null) {
-      fields = {};
-    } else if (typeof value === "object" && !Array.isArray(value)) {
-      fields = value;
-    } else if (Array.isArray(value)) {
-      return { ok: false, message: `${type}: expected a value or a map of fields, not a list` };
-    } else {
-      const field = SHORT_FORM_FIELD[type];
-      if (!field) {
-        return { ok: false, message: `${type} has no short form; write it as a map of fields` };
+  };
+  const replay = async (actions, at) => {
+    for (let index = 0;index < actions.length; index++) {
+      const action = actions[index];
+      if (!action)
+        continue;
+      const path = at(index);
+      if (options.signal?.aborted) {
+        await skipFrom(actions, index, at);
+        return { path, error: "Aborted" };
+      }
+      const step = position++;
+      await emit(path, step, action, "running");
+      let side = null;
+      try {
+        let response;
+        if (action.type === "wait") {
+          await sleep(action.ms, options.signal);
+        } else if (action.type === "assert") {
+          await assertText(action);
+        } else if (action.type === "branch") {
+          const timeoutMs = action.timeoutMs ?? options.defaultBranchTimeoutMs ?? BRANCH_DEFAULT_TIMEOUT_MS;
+          const { met } = await check(action, timeoutMs);
+          const outcome = met ? "then" : "else";
+          side = { outcome, actions: (met ? action.then : action.else) ?? [] };
+          total += side.actions.length;
+        } else {
+          const request = caseScriptActionRequest(action);
+          if (request)
+            response = await client.performAction(request);
+          if (options.pauseAfterActionMs)
+            await sleep(options.pauseAfterActionMs, options.signal);
+        }
+        completed += 1;
+        await emit(path, step, action, "ok", {
+          ...response ? { response } : {},
+          ...side ? { outcome: side.outcome } : {}
+        });
+      } catch (error) {
+        const message = replayErrorMessage(error, options.signal);
+        await emit(path, step, action, "error", { error: message });
+        await skipFrom(actions, index + 1, at);
+        return { path, error: message };
+      }
+      if (side) {
+        const outcome = side.outcome;
+        const failure2 = await replay(side.actions, (inner) => ({
+          index: path.index,
+          nested: [...path.nested, { side: outcome, index: inner }]
+        }));
+        if (failure2) {
+          await skipFrom(actions, index + 1, at);
+          return failure2;
+        }
       }
-      fields = {
-        [field]: TEXT_SHORT_FORM_FIELDS.has(field) && typeof value !== "string" ? String(value) : value
-      };
     }
-  }
-  const allowed = actionFieldNames(type);
-  const unknown = Object.keys(fields).filter((key) => !allowed.has(key));
-  if (unknown.length > 0) {
+    return null;
+  };
+  const failure = await replay(script.actions, (index) => ({ index, nested: [] }));
+  if (failure) {
     return {
       ok: false,
-      message: `${type}: unknown field ${unknown.map((key) => `"${key}"`).join(", ")} (allowed: ${[...allowed].join(", ")})`
+      completed,
+      total,
+      failedIndex: failure.path.index,
+      failedPath: failure.path,
+      error: failure.error
     };
   }
-  const parsed = caseScriptActionSchemaByType[type].safeParse({ type, ...fields });
-  if (!parsed.success) {
-    return { ok: false, message: `${type}: ${zodMessage(parsed.error)}` };
+  return { ok: true, completed, total };
+}
+
+// ../runner-client/src/script-format.ts
+function shellSingleQuote2(value) {
+  return `'${value.replace(/'/g, `'\\''`)}'`;
+}
+function actionToShellLine(action) {
+  if (action.type === "tap") {
+    const parts = ["yoqa", "action", "tap"];
+    if (action.label) {
+      parts.push("--label", shellSingleQuote2(action.label));
+    } else if (action.id) {
+      parts.push("--id", shellSingleQuote2(action.id));
+    } else {
+      parts.push("--x", String(Math.round(action.x ?? 0)), "--y", String(Math.round(action.y ?? 0)));
+    }
+    if (action.double)
+      parts.push("--double");
+    if (action.durationMs != null)
+      parts.push("--duration", String(Math.round(action.durationMs)));
+    return parts.join(" ");
   }
-  return { ok: true, action: parsed.data };
+  if (action.type === "swipe") {
+    const parts = [
+      "yoqa",
+      "action",
+      "swipe",
+      "--x",
+      String(Math.round(action.x)),
+      "--y",
+      String(Math.round(action.y)),
+      "--x2",
+      String(Math.round(action.x2)),
+      "--y2",
+      String(Math.round(action.y2))
+    ];
+    if (action.durationMs != null) {
+      parts.push("--duration", String(Math.round(action.durationMs)));
+    }
+    return parts.join(" ");
+  }
+  if (action.type === "drag") {
+    const parts = [
+      "yoqa",
+      "action",
+      "drag",
+      "--x",
+      String(Math.round(action.x)),
+      "--y",
+      String(Math.round(action.y)),
+      "--x2",
+      String(Math.round(action.x2)),
+      "--y2",
+      String(Math.round(action.y2))
+    ];
+    if (action.durationMs != null) {
+      parts.push("--duration", String(Math.round(action.durationMs)));
+    }
+    return parts.join(" ");
+  }
+  if (action.type === "type") {
+    return `yoqa action input --text ${shellSingleQuote2(action.text)}`;
+  }
+  if (action.type === "assert") {
+    const timeoutSeconds = action.timeoutMs != null ? Math.max(1, Math.round(action.timeoutMs / 1000)) : undefined;
+    const parts = ["yoqa", "assert", action.assertion, "--text", shellSingleQuote2(action.text)];
+    if (timeoutSeconds != null) {
+      parts.push("--timeout", String(timeoutSeconds));
+    }
+    return parts.join(" ");
+  }
+  if (action.type === "alert") {
+    return action.alertAction === "dismiss" ? "yoqa action alert --dismiss" : "yoqa action alert";
+  }
+  if (action.type === "activate-app" || action.type === "terminate-app" || action.type === "restart-app") {
+    return `yoqa action ${action.type} --app-id ${shellSingleQuote2(action.appId)}`;
+  }
+  if (action.type === "background-app") {
+    return action.seconds != null ? `yoqa action background-app --seconds ${action.seconds}` : "yoqa action background-app";
+  }
+  if (action.type === "open-url") {
+    return `yoqa action open-url --url ${shellSingleQuote2(action.url)}`;
+  }
+  if (action.type === "key") {
+    return action.modifiers?.length ? `yoqa action key ${action.key} --modifiers ${action.modifiers.join(",")}` : `yoqa action key ${action.key}`;
+  }
+  if (action.type === "branch") {
+    const check = caseScriptActionCommand(action);
+    const side = (actions) => actions.map((inner) => indentLines(actionToShellLine(inner)));
+    return [
+      `if ${BRANCH_HELPER} ${check}; then`,
+      ...side(action.then),
+      ...action.else?.length ? ["else", ...side(action.else)] : [],
+      "fi"
+    ].join(`
+`);
+  }
+  const seconds = Math.max(0.1, action.ms / 1000);
+  return `sleep ${seconds}`;
 }
-function documentErrors(doc, lineCounter2) {
-  return doc.errors.map((error) => ({
-    line: lineCounter2.linePos(error.pos[0]).line,
-    action: null,
-    message: error.message
-  }));
+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"',
+  "}",
+  ""
+];
+function indentLines(text) {
+  return text.split(`
+`).map((line) => `  ${line}`).join(`
+`);
 }
-function parseCaseScriptFile(text, options = {}) {
-  const lineCounter2 = new $LineCounter;
-  const doc = $parseDocument(text, { lineCounter: lineCounter2, prettyErrors: false });
-  if (doc.errors.length > 0) {
-    return { ok: false, errors: documentErrors(doc, lineCounter2) };
+function formatCaseScriptShell(script, meta = {}) {
+  const titleParts = [
+    meta.caseNumber != null ? `#${meta.caseNumber}` : null,
+    meta.caseName?.trim() || null
+  ].filter(Boolean);
+  const title = titleParts.length > 0 ? titleParts.join(" ") : "exported script";
+  const lines = [
+    "#!/usr/bin/env bash",
+    `# Yoqa exported script — ${title}`,
+    "# Requires an active device session: yoqa devices connect <id>",
+    "# Prefer the Case Script file: `yoqa script run <file.yoqa.yaml>`.",
+    "set -euo pipefail",
+    "",
+    ...script.actions.some((action) => action.type === "branch") ? BRANCH_HELPER_LINES : [],
+    ...script.actions.map(actionToShellLine),
+    ""
+  ];
+  return lines.join(`
+`);
+}
+// ../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 }
+};
+function formatViewportPreset(name) {
+  const { width, height } = VIEWPORT_PRESETS[name];
+  return `${name} (${width}×${height})`;
+}
+
+// ../runner-client/src/run-report.ts
+function readStepCycle(action) {
+  if (!action || typeof action !== "object" || !("cycle" in action))
+    return null;
+  const cycle = action.cycle;
+  if (!cycle || typeof cycle !== "object")
+    return null;
+  const record = cycle;
+  const asRecord = (value) => value && typeof value === "object" ? value : null;
+  const verify = asRecord(record.verify);
+  if (!verify || typeof verify.type !== "string" || !verify.type)
+    return null;
+  return {
+    action: asRecord(record.action),
+    decision: asRecord(record.decision),
+    verify: {
+      type: verify.type,
+      reason: typeof verify.reason === "string" ? verify.reason : null,
+      thoughts: typeof verify.thoughts === "string" ? verify.thoughts : null
+    }
+  };
+}
+function summarizeActionRecord(record) {
+  const type = typeof record.type === "string" ? record.type : "step";
+  if (type === "tap") {
+    if (typeof record.label === "string" && record.label.trim())
+      return `Tap: ${record.label}`;
+    if (typeof record.id === "string" && record.id.trim())
+      return `Tap #${record.id}`;
+    return "Tap";
   }
-  const root = doc.contents;
-  if (!$isMap(root)) {
-    return {
-      ok: false,
-      errors: [
-        {
-          line: lineOf(root, lineCounter2) ?? 1,
-          action: null,
-          message: "expected a Case Script with `version: 1` and `actions:`"
-        }
-      ]
-    };
+  if (type === "type")
+    return `Type${typeof record.text === "string" ? `: ${record.text}` : ""}`;
+  if (type === "wait")
+    return "Wait";
+  if (type === "alert") {
+    return record.alertAction === "dismiss" ? "Dismiss alert" : "Accept alert";
+  }
+  if (type === "assert") {
+    const assertion = typeof record.assertion === "string" ? record.assertion : "visible";
+    const text = typeof record.text === "string" ? record.text : "";
+    return text ? `Assert ${assertion}: ${text}` : `Assert ${assertion}`;
   }
-  const errors3 = [];
-  const top = root.toJS(doc);
-  for (const pair of root.items) {
-    const key = $isScalar(pair.key) ? pair.key.value : pair.key;
-    if (typeof key !== "string" || !TOP_LEVEL_KEYS.has(key)) {
-      errors3.push({
-        line: lineOf(pair.key, lineCounter2),
-        action: null,
-        message: `unknown key "${String(key)}" (allowed: ${[...TOP_LEVEL_KEYS].join(", ")})`
-      });
-    }
+  if (type === "branch") {
+    const assertion = record.assertion === "not-visible" ? "not-visible" : "visible";
+    const id = typeof record.id === "string" ? record.id : undefined;
+    const text = typeof record.text === "string" ? record.text : "";
+    const outcome = typeof record.outcome === "string" ? ` → ${record.outcome}` : "";
+    return `If ${describeScreenCheck({ assertion, text, id })}${outcome}`;
   }
-  const versionNode = root.get("version", true);
-  if (top.version !== 1) {
-    errors3.push({
-      line: lineOf(versionNode, lineCounter2) ?? 1,
-      action: null,
-      message: top.version === undefined ? "missing `version: 1`" : `unsupported version ${JSON.stringify(top.version)} (expected 1)`
-    });
+  if (type === "verify")
+    return "Verify";
+  if (type === "done")
+    return "Done";
+  if (type === "fail")
+    return "Failed";
+  if (type === "swipe") {
+    if (typeof record.direction === "string" && record.direction.trim()) {
+      return `Swipe ${record.direction}`;
+    }
+    const x = typeof record.x === "number" ? record.x : null;
+    const y = typeof record.y === "number" ? record.y : null;
+    const x2 = typeof record.x2 === "number" ? record.x2 : null;
+    const y2 = typeof record.y2 === "number" ? record.y2 : null;
+    if (y != null && y2 != null && x != null && x2 != null) {
+      const dy = y2 - y;
+      const dx = x2 - x;
+      if (Math.abs(dy) >= Math.abs(dx)) {
+        if (dy < -50)
+          return "Swipe up";
+        if (dy > 50)
+          return "Swipe down";
+      } else {
+        if (dx < -50)
+          return "Swipe left";
+        if (dx > 50)
+          return "Swipe right";
+      }
+    }
+    return "Swipe";
   }
-  const name = top.name;
-  if (name != null && typeof name !== "string") {
-    errors3.push({
-      line: lineOf(root.get("name", true), lineCounter2),
-      action: null,
-      message: "name must be text"
-    });
+  if (type === "input") {
+    return `Input${typeof record.text === "string" ? `: ${record.text}` : ""}`;
   }
-  const sourceRunId = top.sourceRunId;
-  if (sourceRunId != null && (typeof sourceRunId !== "string" || sourceRunId.length === 0)) {
-    errors3.push({
-      line: lineOf(root.get("sourceRunId", true), lineCounter2),
-      action: null,
-      message: "sourceRunId must be text"
-    });
+  if (type === "drag")
+    return "Drag";
+  if (type === "activate-app")
+    return "Activate app";
+  if (type === "terminate-app")
+    return "Terminate app";
+  if (type === "restart-app")
+    return "Restart app";
+  if (type === "background-app")
+    return "Background app";
+  if (type === "key") {
+    const modifiers = Array.isArray(record.modifiers) ? record.modifiers.filter((value) => typeof value === "string") : [];
+    return typeof record.key === "string" ? `Press ${formatKeyChord(record.key, modifiers)}` : "Press key";
   }
-  const savedAt = top.savedAt;
-  const legacy = savedAt !== undefined;
-  if (legacy && (typeof savedAt !== "number" || !Number.isInteger(savedAt) || savedAt < 0)) {
-    errors3.push({
-      line: lineOf(root.get("savedAt", true), lineCounter2),
-      action: null,
-      message: "savedAt must be a non-negative whole number"
-    });
+  if (type === "open-url") {
+    return typeof record.url === "string" && record.url.trim() ? `Open URL: ${record.url}` : "Open URL";
   }
-  const actionsNode = root.get("actions", true);
-  const actions = [];
-  const actionLines = [];
-  if (actionsNode != null && !($isScalar(actionsNode) && actionsNode.value == null)) {
-    if (!$isSeq(actionsNode)) {
-      errors3.push({
-        line: lineOf(actionsNode, lineCounter2),
-        action: null,
-        message: "actions must be a list (each item starts with `- `)"
-      });
-    } else {
-      actionsNode.items.forEach((item, index) => {
-        const line = lineOf(item, lineCounter2);
-        const raw = $isNode(item) ? item.toJS(doc) : item;
-        const result = readAction(raw, legacy);
-        if (result.ok) {
-          actions.push(result.action);
-          actionLines.push(line ?? 0);
-        } else {
-          errors3.push({ line, action: index + 1, message: result.message });
-        }
-      });
-    }
-  } else if (!root.has("actions")) {
-    errors3.push({ line: null, action: null, message: "missing `actions:`" });
+  return type.charAt(0).toUpperCase() + type.slice(1);
+}
+function actionSummary(action) {
+  if (!action || typeof action !== "object")
+    return "Step";
+  const cycle = readStepCycle(action);
+  if (cycle?.action)
+    return summarizeActionRecord(cycle.action);
+  if (cycle?.decision)
+    return summarizeActionRecord(cycle.decision);
+  return summarizeActionRecord(action);
+}
+function optionalTrimmedString(value) {
+  return typeof value === "string" && value.trim() ? value.trim() : undefined;
+}
+function optionalFiniteNumber(value) {
+  return typeof value === "number" && Number.isFinite(value) ? value : undefined;
+}
+function formatStepCommand(action) {
+  if (!action || typeof action !== "object")
+    return null;
+  const record = action;
+  const type = typeof record.type === "string" ? record.type : null;
+  if (type == null || type === "verify" || type === "done" || type === "fail")
+    return null;
+  if (type === "wait") {
+    const ms = optionalFiniteNumber(record.ms) ?? 0;
+    return formatSleepShellLine(ms / 1000);
   }
-  if (errors3.length === 0 && actions.length === 0 && !options.allowEmpty) {
-    errors3.push({
-      line: lineOf(actionsNode, lineCounter2),
-      action: null,
-      message: "actions: add at least one action"
+  if (type === "assert" || type === "branch") {
+    const text = optionalTrimmedString(record.text);
+    const id = type === "branch" ? optionalTrimmedString(record.id) : undefined;
+    if (!text && !id)
+      return null;
+    const assertion = record.assertion === "not-visible" ? "not-visible" : "visible";
+    const timeoutMs = optionalFiniteNumber(record.timeoutMs);
+    return formatAssertShellLine({
+      assertion,
+      ...id ? { id } : { text },
+      ...timeoutMs != null ? { timeoutSeconds: timeoutMs / 1000 } : {}
     });
   }
-  if (errors3.length > 0) {
-    return {
-      ok: false,
-      errors: errors3.sort((a, b) => (a.line ?? Number.POSITIVE_INFINITY) - (b.line ?? Number.POSITIVE_INFINITY))
+  let request = null;
+  if (type === "tap") {
+    request = { kind: "tap" };
+    const label = optionalTrimmedString(record.label);
+    const id = optionalTrimmedString(record.id);
+    const x = optionalFiniteNumber(record.x);
+    const y = optionalFiniteNumber(record.y);
+    const durationMs = optionalFiniteNumber(record.durationMs);
+    if (label)
+      request.label = label;
+    if (id)
+      request.id = id;
+    if (x != null)
+      request.x = x;
+    if (y != null)
+      request.y = y;
+    if (record.double === true)
+      request.double = true;
+    if (durationMs != null)
+      request.durationMs = durationMs;
+  } else if (type === "swipe" || type === "drag") {
+    request = { kind: type };
+    const x = optionalFiniteNumber(record.x);
+    const y = optionalFiniteNumber(record.y);
+    const x2 = optionalFiniteNumber(record.x2);
+    const y2 = optionalFiniteNumber(record.y2);
+    const durationMs = optionalFiniteNumber(record.durationMs);
+    if (x != null)
+      request.x = x;
+    if (y != null)
+      request.y = y;
+    if (x2 != null)
+      request.x2 = x2;
+    if (y2 != null)
+      request.y2 = y2;
+    if (durationMs != null)
+      request.durationMs = durationMs;
+  } else if (type === "type" || type === "input") {
+    request = { kind: "input" };
+    const text = optionalTrimmedString(record.text);
+    if (text)
+      request.text = text;
+  } else if (type === "alert") {
+    request = {
+      kind: "alert",
+      alertAction: record.alertAction === "dismiss" ? "dismiss" : "accept"
+    };
+  } else if (type === "activate-app" || type === "terminate-app" || type === "restart-app") {
+    request = { kind: type };
+    const appId = optionalTrimmedString(record.appId);
+    if (appId)
+      request.appId = appId;
+  } else if (type === "background-app") {
+    request = { kind: "background-app" };
+    const seconds = optionalFiniteNumber(record.seconds);
+    if (seconds != null)
+      request.seconds = seconds;
+  } else if (type === "key") {
+    const key = keyNameSchema.safeParse(record.key);
+    const modifiers = exports_external.array(keyModifierSchema).safeParse(record.modifiers);
+    if (!key.success)
+      return null;
+    request = {
+      kind: "key",
+      key: key.data,
+      ...modifiers.success && modifiers.data.length > 0 ? { modifiers: modifiers.data } : {}
     };
+  } else if (type === "open-url") {
+    request = { kind: "open-url" };
+    const url = optionalTrimmedString(record.url);
+    if (url)
+      request.url = url;
+  }
+  return request ? formatActionShellLine(request) : null;
+}
+function stepReasoning(step) {
+  const action = step.action && typeof step.action === "object" ? step.action : null;
+  const reasonFromAction = typeof action?.reason === "string" && action.reason.trim() ? action.reason.trim() : null;
+  const thoughtsFromAction = typeof action?.thoughts === "string" && action.thoughts.trim() ? action.thoughts.trim() : null;
+  const reason = reasonFromAction ?? (step.detail?.trim() ? step.detail.trim() : null);
+  const thoughts = thoughtsFromAction && thoughtsFromAction !== reason ? thoughtsFromAction : null;
+  return { reason, thoughts };
+}
+function toReportStatus(status) {
+  if (status === "passed" || status === "errored" || status === "cancelled")
+    return status;
+  return null;
+}
+function formatStepPhases(phases) {
+  const parts = [
+    `capture ${Math.round(phases.captureMs)}ms`,
+    `screen ${Math.round(phases.screenMs)}ms`,
+    `image ${Math.round(phases.prepareMs)}ms`,
+    `decide ${Math.round(phases.decideMs)}ms`,
+    `action ${Math.round(phases.actionMs)}ms`,
+    `settle ${Math.round(phases.settleMs)}ms`
+  ];
+  if (phases.decideRetries > 0) {
+    parts.push(`retries ${phases.decideRetries}`);
+  }
+  const usage = phases.usage ? formatCallUsage(phases.usage) : null;
+  if (usage)
+    parts.push(usage);
+  return parts.join(" · ");
+}
+function formatCallUsage(usage) {
+  const fields = [
+    usage.inputTokens != null ? `in ${usage.inputTokens}` : null,
+    usage.cachedInputTokens != null ? `cached ${usage.cachedInputTokens}` : null,
+    usage.cacheWriteTokens != null ? `cache write ${usage.cacheWriteTokens}` : null,
+    usage.outputTokens != null ? `out ${usage.outputTokens}` : null
+  ].filter((field) => field != null);
+  if (fields.length === 0)
+    return null;
+  const cached = usage.cachedInputTokens ?? 0;
+  const totalInput = (usage.inputTokens ?? 0) + cached + (usage.cacheWriteTokens ?? 0);
+  const share = totalInput > 0 ? ` (${Math.round(cached / totalInput * 100)}% cached)` : "";
+  return `usage ${fields.join(", ")}${share}`;
+}
+function mapCatalogStep(step, screenshotsByStepId) {
+  const { reason, thoughts } = stepReasoning(step);
+  return {
+    id: step.id,
+    index: step.idx + 1,
+    summary: actionSummary(step.action),
+    ok: step.ok,
+    latencyMs: step.latencyMs,
+    phases: step.phases ?? null,
+    detail: step.detail,
+    reason,
+    thoughts,
+    command: step.command ?? formatStepCommand(step.action),
+    screenshotBase64: screenshotsByStepId[step.id] ?? null
+  };
+}
+function buildRunReportFromCatalogRun(run, meta = {}, screenshotsByStepId = {}) {
+  const status = toReportStatus(run.status);
+  if (!status) {
+    throw new Error(`Cannot export report for live run status: ${run.status}`);
   }
+  const caseTitles = meta.caseTitles ?? {};
+  const tests = run.tests.map((test) => ({
+    id: test.id,
+    title: caseTitles[test.caseId] ?? test.caseId,
+    status: test.status,
+    executionMode: test.executionMode ?? null,
+    error: test.error,
+    startedAt: test.startedAt,
+    finishedAt: test.finishedAt,
+    steps: (test.steps ?? []).map((step) => mapCatalogStep(step, screenshotsByStepId))
+  }));
+  const primaryTitle = tests[0]?.title ?? "Run";
   return {
-    ok: true,
-    name: typeof name === "string" && name.trim().length > 0 ? name.trim() : null,
-    actionLines,
-    script: {
-      version: 1,
-      ...typeof sourceRunId === "string" ? { sourceRunId } : {},
-      savedAt: typeof savedAt === "number" ? savedAt : options.savedAt ?? Date.now(),
-      actions
-    }
+    id: run.id,
+    source: "catalog",
+    status,
+    title: primaryTitle,
+    appLabel: meta.appLabel ?? null,
+    deviceLabel: meta.deviceLabel ?? null,
+    platform: run.platform,
+    executionMode: run.executionMode,
+    screenMode: run.screenMode ?? null,
+    lane: run.lane ?? null,
+    laneWarning: run.laneWarning ?? null,
+    browser: run.browser ?? null,
+    viewport: run.viewport ?? null,
+    error: run.error,
+    createdAt: run.createdAt,
+    startedAt: run.startedAt,
+    finishedAt: run.finishedAt,
+    tests
   };
 }
-function formatCaseScriptFileErrors(errors3) {
-  return errors3.map((error) => {
-    const where = [
-      error.line != null ? `Line ${error.line}` : null,
-      error.action != null ? `action ${error.action}` : null
-    ].filter(Boolean).join(", ");
-    return where ? `${where}: ${error.message}` : error.message;
-  }).join(`
-`);
+function suggestedRunReportBasename(doc) {
+  const shortId = doc.id.replace(/[^a-zA-Z0-9]+/g, "").slice(0, 8) || "run";
+  const raw = ["yoqa-run", shortId, doc.status].join("-").toLowerCase().replace(/[^a-z0-9-]+/g, "-").replace(/-+/g, "-").replace(/^-|-$/g, "");
+  return raw || "yoqa-run-report";
 }
-var FLOW_OPTIONS = {
-  collectionStyle: "flow",
-  lineWidth: 0,
-  blockQuote: false,
-  flowCollectionPadding: false
-};
-function yamlScalar(value) {
-  if (typeof value === "string" && /[\n\r\t]/.test(value))
-    return JSON.stringify(value);
-  return $stringify([value], FLOW_OPTIONS).trim().slice(1, -1);
+function escapeHtml(value) {
+  return value.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;").replace(/'/g, "&#39;");
 }
-function orderedFields(action) {
-  const fields = Object.entries(action).filter(([key, value]) => key !== "type" && value !== undefined);
-  const meaningful = fields.filter(([key, value]) => !(action.type === "assert" && key === "assertion" && value === "visible") && !(action.type === "alert" && key === "alertAction" && value === "accept"));
-  const rank = (key) => {
-    const at = FIELD_ORDER.indexOf(key);
-    return at < 0 ? FIELD_ORDER.length : at;
-  };
-  return meaningful.sort(([a], [b]) => rank(a) - rank(b));
+function formatWhen(ms) {
+  if (ms == null)
+    return "—";
+  return new Date(ms).toLocaleString();
 }
-function formatCaseScriptFileAction(action) {
-  const fields = orderedFields(action);
-  const shortField = SHORT_FORM_FIELD[action.type];
-  if (action.type === "alert" && fields.length === 0) {
-    return `alert: ${action.alertAction}`;
-  }
-  const only = fields[0];
-  if (fields.length === 1 && only && only[0] === shortField) {
-    return `${action.type}: ${yamlScalar(only[1])}`;
+function formatDuration(startedAt, finishedAt) {
+  if (startedAt == null || finishedAt == null)
+    return "—";
+  const ms = Math.max(0, finishedAt - startedAt);
+  if (ms < 1000)
+    return `${ms}ms`;
+  const seconds = ms / 1000;
+  if (seconds < 60)
+    return `${seconds.toFixed(1)}s`;
+  const minutes = Math.floor(seconds / 60);
+  const rem = Math.round(seconds % 60);
+  return `${minutes}m ${rem}s`;
+}
+function statusAccent(status) {
+  if (status === "passed") {
+    return { bg: "#dcfce7", fg: "#166534", label: "Passed" };
   }
-  if (fields.length === 0) {
-    return `${action.type}: {}`;
+  if (status === "errored") {
+    return { bg: "#fee2e2", fg: "#991b1b", label: "Failed" };
   }
-  const body = fields.map(([key, value]) => `${key}: ${yamlScalar(value)}`).join(", ");
-  return `${action.type}: { ${body} }`;
+  return { bg: "#e5e7eb", fg: "#374151", label: "Cancelled" };
 }
-function formatCaseScriptFileActionLine(action) {
-  return `  - ${formatCaseScriptFileAction(action)}`;
+function pngDataUri(base64) {
+  return `data:image/png;base64,${base64}`;
 }
-function formatCaseScriptFile(script, options = {}) {
-  const lines = ["version: 1"];
-  const name = options.name?.trim();
-  if (name)
-    lines.push(`name: ${yamlScalar(name)}`);
-  if (script.sourceRunId)
-    lines.push(`sourceRunId: ${yamlScalar(script.sourceRunId)}`);
-  lines.push("actions:");
-  for (const action of script.actions) {
-    lines.push(formatCaseScriptFileActionLine(action));
+function formatRunReportHtml(doc) {
+  const accent = statusAccent(doc.status);
+  const screenRows = [
+    ...doc.screenMode ? [["Screen", doc.screenMode]] : [],
+    ...doc.lane ? [["Lane", doc.lane]] : [],
+    ...doc.laneWarning ? [["Lane warning", doc.laneWarning]] : []
+  ];
+  const metaRows = [
+    ["Status", accent.label],
+    ["Source", doc.source === "catalog" ? "Catalog run" : "Manual Inspector"],
+    ["App", doc.appLabel ?? "—"],
+    ["Device", doc.deviceLabel ?? "—"],
+    ["Platform", doc.platform ?? "—"],
+    ...doc.browser ? [["Browser", doc.browser]] : [],
+    ...doc.viewport ? [["Viewport", formatViewportPreset(doc.viewport)]] : [],
+    ["Mode", doc.executionMode ?? "—"],
+    ...screenRows,
+    ["Started", formatWhen(doc.startedAt ?? doc.createdAt)],
+    ["Finished", formatWhen(doc.finishedAt)],
+    ["Duration", formatDuration(doc.startedAt ?? doc.createdAt, doc.finishedAt)],
+    ["Run ID", doc.id]
+  ];
+  const testsHtml = doc.tests.map((test, testIndex) => {
+    const testAccent = statusAccent(test.status === "passed" || test.status === "errored" || test.status === "cancelled" ? test.status : doc.status);
+    const stepsHtml = test.steps.map((step) => {
+      const stepStatus = step.ok ? "Passed" : "Failed";
+      const stepColor = step.ok ? "#166534" : "#991b1b";
+      const reasonBlock = step.reason ? `<p class="reason">${escapeHtml(step.reason)}</p>` : "";
+      const thoughtsBlock = step.thoughts ? `<details class="thoughts"><summary>AI thoughts</summary><p>${escapeHtml(step.thoughts)}</p></details>` : "";
+      const detailBlock = step.detail && step.detail !== step.reason ? `<p class="detail">${escapeHtml(step.detail)}</p>` : "";
+      const shot = step.screenshotBase64 ? `<img class="shot" alt="Step ${step.index} screenshot" src="${pngDataUri(step.screenshotBase64)}" />` : `<p class="muted">No screenshot</p>`;
+      const latency = step.latencyMs != null ? `<span class="muted">${step.latencyMs}ms</span>` : "";
+      const phases = step.phases ? `<p class="muted phases">Phases: ${escapeHtml(formatStepPhases(step.phases))}</p>` : "";
+      const commandBlock = step.command ? `<pre class="command"><code>${escapeHtml(step.command)}</code></pre>` : "";
+      return `
+<article class="step ${step.ok ? "ok" : "fail"}">
+  <header>
+    <span class="idx">${step.index}</span>
+    <div>
+      <h3>${escapeHtml(step.summary)}</h3>
+      <p class="step-status" style="color:${stepColor}">${stepStatus} ${latency}</p>
+    </div>
+  </header>
+  ${commandBlock}
+  ${phases}
+  ${reasonBlock}
+  ${detailBlock}
+  ${thoughtsBlock}
+  ${shot}
+</article>`;
+    }).join(`
+`);
+    return `
+<section class="test">
+  <h2>
+    <span class="test-num">${testIndex + 1}</span>
+    ${escapeHtml(test.title)}
+    <span class="pill" style="background:${testAccent.bg};color:${testAccent.fg}">${escapeHtml(testAccent.label)}</span>
+  </h2>
+  ${test.error ? `<p class="error">${escapeHtml(test.error)}</p>` : ""}
+  ${test.executionMode ? `<p class="muted">Mode: ${escapeHtml(test.executionMode)}</p>` : ""}
+  <div class="steps">${stepsHtml || `<p class="muted">No steps recorded</p>`}</div>
+</section>`;
+  }).join(`
+`);
+  const metaHtml = metaRows.map(([label, value]) => `<tr><th>${escapeHtml(label)}</th><td>${escapeHtml(value)}</td></tr>`).join(`
+`);
+  return `<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="utf-8" />
+<meta name="viewport" content="width=device-width, initial-scale=1" />
+<title>Yoqa Report — ${escapeHtml(doc.title)} (${escapeHtml(accent.label)})</title>
+<style>
+  :root { color-scheme: light; }
+  body { font-family: ui-sans-serif, system-ui, -apple-system, Segoe UI, Roboto, sans-serif; margin: 0; background: #f8fafc; color: #0f172a; line-height: 1.5; }
+  .wrap { max-width: 52rem; margin: 0 auto; padding: 2rem 1.25rem 4rem; }
+  .banner { border-radius: 1rem; padding: 1.25rem 1.5rem; background: ${accent.bg}; color: ${accent.fg}; margin-bottom: 1.5rem; }
+  .banner h1 { margin: 0 0 0.35rem; font-size: 1.5rem; }
+  .banner p { margin: 0; opacity: 0.9; }
+  table.meta { width: 100%; border-collapse: collapse; background: #fff; border-radius: 0.75rem; overflow: hidden; box-shadow: 0 1px 2px rgb(0 0 0 / 0.06); margin-bottom: 2rem; }
+  table.meta th, table.meta td { text-align: left; padding: 0.65rem 1rem; border-bottom: 1px solid #e2e8f0; font-size: 0.9rem; }
+  table.meta th { width: 8rem; color: #64748b; font-weight: 600; }
+  .error { background: #fee2e2; color: #991b1b; padding: 0.75rem 1rem; border-radius: 0.5rem; }
+  .test { margin-bottom: 2.5rem; }
+  .test h2 { display: flex; flex-wrap: wrap; align-items: center; gap: 0.5rem; font-size: 1.15rem; }
+  .test-num { display: inline-flex; align-items: center; justify-content: center; width: 1.75rem; height: 1.75rem; border-radius: 999px; background: #0f172a; color: #fff; font-size: 0.8rem; }
+  .pill { display: inline-flex; align-items: center; border-radius: 999px; padding: 0.15rem 0.65rem; font-size: 0.75rem; font-weight: 600; }
+  .step { background: #fff; border: 1px solid #e2e8f0; border-radius: 0.75rem; padding: 1rem; margin: 0.75rem 0; }
+  .step.fail { border-color: #fecaca; }
+  .step header { display: flex; gap: 0.75rem; align-items: flex-start; }
+  .step .idx { flex-shrink: 0; width: 1.75rem; height: 1.75rem; border-radius: 999px; background: #e2e8f0; display: inline-flex; align-items: center; justify-content: center; font-size: 0.75rem; font-weight: 700; }
+  .step.ok .idx { background: #bbf7d0; color: #166534; }
+  .step.fail .idx { background: #fecaca; color: #991b1b; }
+  .step h3 { margin: 0; font-size: 1rem; }
+  .step-status { margin: 0.15rem 0 0; font-size: 0.8rem; font-weight: 600; }
+  .command { margin: 0.5rem 0 0; padding: 0.4rem 0.65rem; background: #f1f5f9; border-radius: 0.4rem; font-size: 0.8rem; overflow-x: auto; }
+  .command code { font-family: ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, monospace; }
+  .reason, .detail { margin: 0.5rem 0 0; color: #475569; font-size: 0.9rem; }
+  .thoughts { margin-top: 0.5rem; font-size: 0.85rem; color: #64748b; }
+  .thoughts p { margin: 0.35rem 0 0; white-space: pre-wrap; }
+  .shot { display: block; max-width: 100%; width: min(22rem, 100%); margin-top: 0.75rem; border-radius: 0.75rem; border: 1px solid #e2e8f0; }
+  .muted { color: #94a3b8; font-size: 0.85rem; }
+  footer { margin-top: 2rem; color: #94a3b8; font-size: 0.8rem; }
+  @media print {
+    body { background: #fff; }
+    .shot { max-height: 60vh; object-fit: contain; }
   }
-  return `${lines.join(`
-`)}
+</style>
+</head>
+<body>
+  <div class="wrap">
+    <header class="banner">
+      <h1>${escapeHtml(doc.title)}</h1>
+      <p>${escapeHtml(accent.label)} · Yoqa end-to-end report</p>
+    </header>
+    ${doc.error ? `<p class="error">${escapeHtml(doc.error)}</p>` : ""}
+    <table class="meta">${metaHtml}</table>
+    ${testsHtml}
+    <footer>Generated by Yoqa</footer>
+  </div>
+</body>
+</html>
 `;
 }
-// ../runner-client/src/case-script-replay.ts
-var DEFAULT_ASSERT_TIMEOUT_MS = 5000;
-function abortError() {
-  return Object.assign(new Error("Aborted"), { name: "AbortError" });
+function escapeMd(value) {
+  return value.replace(/\|/g, "\\|").replace(/\r?\n/g, " ");
 }
-function realSleep(ms, signal) {
-  if (ms <= 0)
-    return Promise.resolve();
-  return new Promise((resolve, reject) => {
-    if (signal?.aborted) {
-      reject(abortError());
+function formatRunReportMarkdown(doc) {
+  const accent = statusAccent(doc.status);
+  const lines = [
+    `# Yoqa Report — ${doc.title}`,
+    "",
+    `**Status:** ${accent.label}`,
+    "",
+    "| Field | Value |",
+    "| --- | --- |",
+    `| Source | ${doc.source === "catalog" ? "Catalog run" : "Manual Inspector"} |`,
+    `| App | ${escapeMd(doc.appLabel ?? "—")} |`,
+    `| Device | ${escapeMd(doc.deviceLabel ?? "—")} |`,
+    `| Platform | ${escapeMd(doc.platform ?? "—")} |`,
+    ...doc.browser ? [`| Browser | ${escapeMd(doc.browser)} |`] : [],
+    ...doc.viewport ? [`| Viewport | ${escapeMd(formatViewportPreset(doc.viewport))} |`] : [],
+    `| Mode | ${escapeMd(doc.executionMode ?? "—")} |`,
+    ...doc.screenMode ? [`| Screen | ${escapeMd(doc.screenMode)} |`] : [],
+    ...doc.lane ? [`| Lane | ${escapeMd(doc.lane)} |`] : [],
+    ...doc.laneWarning ? [`| Lane warning | ${escapeMd(doc.laneWarning)} |`] : [],
+    `| Started | ${escapeMd(formatWhen(doc.startedAt ?? doc.createdAt))} |`,
+    `| Finished | ${escapeMd(formatWhen(doc.finishedAt))} |`,
+    `| Duration | ${escapeMd(formatDuration(doc.startedAt ?? doc.createdAt, doc.finishedAt))} |`,
+    `| Run ID | \`${doc.id}\` |`,
+    ""
+  ];
+  if (doc.error) {
+    lines.push(`> **Error:** ${doc.error}`, "");
+  }
+  doc.tests.forEach((test, testIndex) => {
+    const testLabel = test.status === "passed" ? "Passed" : test.status === "errored" ? "Failed" : test.status === "cancelled" ? "Cancelled" : test.status;
+    lines.push(`## ${testIndex + 1}. ${test.title} (${testLabel})`, "");
+    if (test.executionMode)
+      lines.push(`Mode: \`${test.executionMode}\``, "");
+    if (test.error)
+      lines.push(`**Error:** ${test.error}`, "");
+    if (test.steps.length === 0) {
+      lines.push("_No steps recorded_", "");
       return;
     }
-    const timer = setTimeout(() => {
-      signal?.removeEventListener("abort", onAbort);
-      resolve();
-    }, ms);
-    const onAbort = () => {
-      clearTimeout(timer);
-      reject(abortError());
-    };
-    signal?.addEventListener("abort", onAbort, { once: true });
-  });
-}
-function caseScriptActionRequest(action) {
-  switch (action.type) {
-    case "tap": {
-      const request = { kind: "tap" };
-      if (action.label)
-        request.label = action.label;
-      if (action.id)
-        request.id = action.id;
-      if (action.x != null)
-        request.x = action.x;
-      if (action.y != null)
-        request.y = action.y;
-      if (action.double)
-        request.double = true;
-      if (action.durationMs != null)
-        request.durationMs = action.durationMs;
-      return request;
+    for (const step of test.steps) {
+      lines.push(`### Step ${step.index}: ${step.summary}`);
+      lines.push("");
+      lines.push(`- Result: **${step.ok ? "Passed" : "Failed"}**`);
+      if (step.command)
+        lines.push(`- Command: \`${step.command.replace(/`/g, "'")}\``);
+      if (step.latencyMs != null)
+        lines.push(`- Latency: ${step.latencyMs}ms`);
+      if (step.phases)
+        lines.push(`- Phases: ${formatStepPhases(step.phases)}`);
+      if (step.reason)
+        lines.push(`- Reason: ${step.reason}`);
+      if (step.detail && step.detail !== step.reason)
+        lines.push(`- Detail: ${step.detail}`);
+      if (step.thoughts) {
+        lines.push("", "<details><summary>AI thoughts</summary>", "", step.thoughts, "", "</details>");
+      }
+      if (step.screenshotBase64) {
+        lines.push("", `![Step ${step.index} screenshot](${pngDataUri(step.screenshotBase64)})`);
+      } else {
+        lines.push("", "_No screenshot_");
+      }
+      lines.push("");
     }
-    case "swipe":
-    case "drag":
-      return {
-        kind: action.type,
-        x: action.x,
-        y: action.y,
-        x2: action.x2,
-        y2: action.y2,
-        ...action.durationMs != null ? { durationMs: action.durationMs } : {}
-      };
-    case "type":
-      return { kind: "input", text: action.text };
-    case "alert":
-      return { kind: "alert", alertAction: action.alertAction };
-    case "activate-app":
-    case "terminate-app":
-    case "restart-app":
-      return { kind: action.type, appId: action.appId };
-    case "background-app":
-      return {
-        kind: "background-app",
-        ...action.seconds != null ? { seconds: action.seconds } : {}
-      };
-    case "open-url":
-      return { kind: "open-url", url: action.url };
-    case "wait":
-    case "assert":
-      return null;
-  }
+  });
+  lines.push("---", "", "_Generated by Yoqa_", "");
+  return lines.join(`
+`);
 }
-function caseScriptActionCommand(action) {
-  if (action.type === "wait") {
-    const seconds = action.ms / 1000;
-    return `sleep ${Number.isInteger(seconds) ? seconds : Number(seconds.toFixed(3))}`;
+function formatRunReportGithubSummary(doc) {
+  const accent = statusAccent(doc.status);
+  const passed = doc.tests.filter((test) => test.status === "passed").length;
+  const failed = doc.tests.filter((test) => test.status === "errored").length;
+  const cancelled = doc.tests.filter((test) => test.status === "cancelled").length;
+  const failedSteps = doc.tests.flatMap((test) => test.steps.filter((step) => !step.ok).map((step) => ({ test, step })));
+  const lines = [
+    `## Yoqa Report — ${doc.title}`,
+    "",
+    `**${accent.label}** · ${doc.tests.length} test${doc.tests.length === 1 ? "" : "s"} · ${passed} passed · ${failed} failed · ${cancelled} cancelled`,
+    "",
+    "| Field | Value |",
+    "| --- | --- |",
+    `| App | ${escapeMd(doc.appLabel ?? "—")} |`,
+    `| Device | ${escapeMd(doc.deviceLabel ?? "—")} |`,
+    `| Platform | ${escapeMd(doc.platform ?? "—")} |`,
+    ...doc.browser ? [`| Browser | ${escapeMd(doc.browser)} |`] : [],
+    ...doc.viewport ? [`| Viewport | ${escapeMd(formatViewportPreset(doc.viewport))} |`] : [],
+    `| Mode | ${escapeMd(doc.executionMode ?? "—")} |`,
+    ...doc.screenMode ? [`| Screen | ${escapeMd(doc.screenMode)} |`] : [],
+    ...doc.lane ? [`| Lane | ${escapeMd(doc.lane)} |`] : [],
+    ...doc.laneWarning ? [`| Lane warning | ${escapeMd(doc.laneWarning)} |`] : [],
+    `| Duration | ${escapeMd(formatDuration(doc.startedAt ?? doc.createdAt, doc.finishedAt))} |`,
+    `| Run ID | \`${doc.id}\` |`,
+    ""
+  ];
+  if (doc.error) {
+    lines.push(`> **Error:** ${doc.error}`, "");
   }
-  if (action.type === "assert") {
-    const timeout = action.timeoutMs != null ? ` --timeout ${Math.max(1, Math.round(action.timeoutMs / 1000))}` : "";
-    return `yoqa assert ${action.assertion} --text '${action.text.replace(/'/g, `'\\''`)}'${timeout}`;
+  if (doc.tests.length > 0) {
+    lines.push("### Tests", "", "| # | Test | Status | Steps |", "| --- | --- | --- | --- |");
+    doc.tests.forEach((test, testIndex) => {
+      const testLabel = test.status === "passed" ? "Passed" : test.status === "errored" ? "Failed" : test.status === "cancelled" ? "Cancelled" : test.status;
+      lines.push(`| ${testIndex + 1} | ${escapeMd(test.title)} | ${testLabel} | ${test.steps.length} |`);
+    });
+    lines.push("");
   }
-  const request = caseScriptActionRequest(action);
-  return request ? formatActionShellLine(request) : action.type;
-}
-async function runCaseScript(client, script, options = {}) {
-  const sleep = options.sleep ?? realSleep;
-  const now = options.now ?? Date.now;
-  const pollMs = options.assertPollMs ?? 400;
-  const { actions } = script;
-  const total = actions.length;
-  const skipFrom = async (from) => {
-    for (let index = from;index < total; index++) {
-      const action = actions[index];
-      if (action)
-        await options.onStep?.({ index, total, action, status: "skipped" });
-    }
-  };
-  const assertText = async (action) => {
-    const timeoutMs = action.timeoutMs ?? options.defaultAssertTimeoutMs ?? DEFAULT_ASSERT_TIMEOUT_MS;
-    const deadline = now() + timeoutMs;
-    const seconds = Math.round(timeoutMs / 1000);
-    for (;; ) {
-      if (options.signal?.aborted)
-        throw abortError();
-      let readError = null;
-      try {
-        const screen = await client.getScreen();
-        const found = screenHasText(screen.elements, action.text);
-        if (action.assertion === "visible" ? found : !found)
-          return;
-      } catch (error) {
-        readError = error;
-      }
-      if (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(action.assertion === "visible" ? `Expected visible text not found within ${seconds}s: ${action.text}` : `Unexpected text still visible after ${seconds}s: ${action.text}`);
+  if (failedSteps.length > 0) {
+    lines.push("### Failed steps", "");
+    for (const { test, step } of failedSteps) {
+      lines.push(`- **${escapeMd(test.title)}** · step ${step.index}: ${escapeMd(step.summary)}`);
+      if (step.command)
+        lines.push(`  - Command: \`${escapeMd(step.command)}\``);
+      if (step.reason)
+        lines.push(`  - Reason: ${escapeMd(step.reason)}`);
+      if (step.detail && step.detail !== step.reason) {
+        lines.push(`  - Detail: ${escapeMd(step.detail)}`);
       }
-      await sleep(pollMs, options.signal);
-    }
-  };
-  for (let index = 0;index < total; index++) {
-    const action = actions[index];
-    if (!action)
-      continue;
-    if (options.signal?.aborted) {
-      await skipFrom(index);
-      return { ok: false, completed: index, total, failedIndex: index, error: "Aborted" };
-    }
-    await options.onStep?.({ index, total, action, status: "running" });
-    try {
-      let response;
-      if (action.type === "wait") {
-        await sleep(action.ms, options.signal);
-      } else if (action.type === "assert") {
-        await assertText(action);
-      } else {
-        const request = caseScriptActionRequest(action);
-        if (request)
-          response = await client.performAction(request);
-        if (options.pauseAfterActionMs)
-          await sleep(options.pauseAfterActionMs, options.signal);
-      }
-      await options.onStep?.({
-        index,
-        total,
-        action,
-        status: "ok",
-        ...response ? { response } : {}
-      });
-    } catch (error) {
-      const aborted = options.signal?.aborted || error instanceof Error && error.name === "AbortError";
-      const message = aborted ? "Aborted" : error instanceof Error ? error.message : String(error);
-      await options.onStep?.({ index, total, action, status: "error", error: message });
-      await skipFrom(index + 1);
-      return { ok: false, completed: index, total, failedIndex: index, error: message };
     }
+    lines.push("");
   }
-  return { ok: true, completed: total, total };
+  lines.push("Download the `yoqa-report` artifact for the full HTML report with screenshots.", "");
+  return lines.join(`
+`);
 }
 // ../runner-client/src/index.ts
 var DEFAULT_BASE_URL = "http://127.0.0.1:7420";
@@ -16392,7 +16512,7 @@ function recommendScreenDefault(vision, tree) {
 // package.json
 var package_default = {
   name: "@yoqa/cli",
-  version: "1.0.2",
+  version: "1.0.4",
   description: "Yoqa CLI — drive local mobile QA from the terminal or CI (talks to the Yoqa runner over HTTP)",
   license: "UNLICENSED",
   type: "module",
@@ -16429,7 +16549,7 @@ var package_default = {
     health: "bun run src/main.ts health"
   },
   dependencies: {
-    "@yoqa/runner": "1.0.2"
+    "@yoqa/runner": "1.0.4"
   },
   devDependencies: {
     "@types/node": "^22.15.30",
@@ -16919,6 +17039,41 @@ function commandChainIncludes(command, name) {
   return false;
 }
 
+// src/platform.ts
+var PLATFORM_DEVICES_DESCRIPTION = {
+  ios: "List iOS devices and simulators",
+  android: "List Android devices and emulators",
+  web: "List installed web browsers (attach a Chromium you started by naming its port: chromium-cdp-<port>)"
+};
+function parsePlatform(value) {
+  const parsed = devicePlatformSchema.safeParse(value);
+  if (!parsed.success) {
+    const names = devicePlatformSchema.options.map((option) => option.value);
+    throw new Error(`--platform must be ${names.slice(0, -1).join(", ")} or ${names.at(-1)}`);
+  }
+  return parsed.data;
+}
+var WEB_DEVICE_ID = /^(web-(chrome|edge|brave|chromium)|chromium-cdp-\d+)$/;
+function isWebDeviceId(deviceId) {
+  return WEB_DEVICE_ID.test(deviceId);
+}
+function connectPlatform(deviceId, value) {
+  if (value === undefined && isWebDeviceId(deviceId))
+    return "web";
+  return parsePlatform(value);
+}
+function parseViewportPreset(value, platform) {
+  if (value === undefined)
+    return;
+  if (platform !== "web") {
+    throw new Error("--viewport is for web devices: a phone's screen is its own size");
+  }
+  const preset = VIEWPORT_PRESET_NAMES.find((name) => name === value.trim().toLowerCase());
+  if (!preset)
+    throw new Error(`--viewport must be ${VIEWPORT_PRESET_NAMES.join(" or ")}`);
+  return preset;
+}
+
 // src/report.ts
 import { mkdir as mkdir3, writeFile as writeFile2 } from "node:fs/promises";
 import { dirname as dirname3 } from "node:path";
@@ -17207,6 +17362,10 @@ program2.name("yoqa").description("Local Yoqa CLI (talks to the local runner ove
 function client(baseUrl) {
   return createRunnerClient({ baseUrl });
 }
+function describeSession(body) {
+  const viewport = body.viewport ? ` viewport ${formatViewportPreset(body.viewport)}` : "";
+  return `${body.platform} ${body.deviceId} lane ${body.lane ?? "direct"}${viewport}`;
+}
 function fail(command, error) {
   const message = error instanceof Error ? error.message : String(error);
   console.error(`yoqa ${command} failed: ${message}`);
@@ -17343,8 +17502,8 @@ function printDevicesTable(devicesList) {
     }
   }
 }
-for (const platform of ["ios", "android"]) {
-  devices.command(platform).description(`List ${platform === "ios" ? "iOS devices and simulators" : "Android devices and emulators"}`).option("--base-url <url>", "Runner base URL", runnerBaseUrl()).option("--json", "Print raw JSON").option("--all", "Include unavailable / shutdown devices", true).option("--booted-only", "Only show booted / online devices").action(async (options) => {
+for (const platform of Object.keys(PLATFORM_DEVICES_DESCRIPTION)) {
+  devices.command(platform).description(PLATFORM_DEVICES_DESCRIPTION[platform]).option("--base-url <url>", "Runner base URL", runnerBaseUrl()).option("--json", "Print raw JSON").option("--all", "Include unavailable / shutdown devices", true).option("--booted-only", "Only show booted / online devices").action(async (options) => {
     try {
       const includeUnavailable = options.bootedOnly ? false : options.all !== false;
       const body = await client(options.baseUrl).listDevices(platform, {
@@ -17360,28 +17519,27 @@ for (const platform of ["ios", "android"]) {
     }
   });
 }
-devices.command("connect").description("Open a Device Session on a device").argument("<deviceId>", "Device UDID / serial").requiredOption("--platform <platform>", "ios | android").option("--base-url <url>", "Runner base URL", runnerBaseUrl()).option("--bundle-id <id>", "iOS bundle id to launch").option("--app-package <id>", "Android application id to launch").option("--lane <lane>", "direct | auto (the only Lane is Direct)").option("--json", "Print raw JSON").action(async (deviceId, options) => {
+devices.command("connect").description("Open a Device Session on a device").argument("<deviceId>", "Device UDID / serial, a browser id (web-chrome), or chromium-cdp-<port> for a Chromium you started").option("--platform <platform>", "ios | android | web (web for web-* and chromium-cdp-<port>)").option("--base-url <url>", "Runner base URL", runnerBaseUrl()).option("--bundle-id <id>", "iOS bundle id to launch").option("--app-package <id>", "Android application id to launch").option("--lane <lane>", "direct | auto (the only Lane is Direct)").option("--viewport <preset>", "Web only: desktop (1280×800, the default) | mobile (390×844, touch and a mobile user agent)").option("--json", "Print raw JSON").action(async (deviceId, options) => {
   try {
-    const platform = options.platform;
-    if (platform !== "ios" && platform !== "android") {
-      throw new Error("--platform must be ios or android");
-    }
+    const platform = connectPlatform(deviceId, options.platform);
     const lane = options.lane;
     if (lane != null && lane !== "direct" && lane !== "auto") {
       throw new Error("--lane must be direct or auto");
     }
+    const viewport = parseViewportPreset(options.viewport, platform);
     const body = await client(options.baseUrl).connectDevice({
       deviceId,
       platform,
       bundleId: options.bundleId,
       appPackage: options.appPackage,
-      lane
+      lane,
+      ...viewport ? { viewport } : {}
     });
     if (options.json) {
       console.log(JSON.stringify(body, null, 2));
       return;
     }
-    console.log(`connected ${body.platform} ${body.deviceId} lane ${body.lane ?? "direct"}`);
+    console.log(`connected ${describeSession(body)}`);
     if (body.laneWarning)
       console.log(`lane warning: ${body.laneWarning}`);
   } catch (error) {
@@ -17406,7 +17564,7 @@ devices.command("active").description("Show the currently connected device").opt
       console.log(JSON.stringify(body, null, 2));
       return;
     }
-    console.log(`${body.platform} ${body.deviceId} lane ${body.lane ?? "direct"}`);
+    console.log(describeSession(body));
     if (body.laneWarning)
       console.log(`lane warning: ${body.laneWarning}`);
   } catch (error) {
@@ -17453,7 +17611,7 @@ program2.command("screenshot").description("Capture a screenshot from the active
 });
 var action = program2.command("action").description("Perform an action on the active device");
 function addActionOptions(cmd) {
-  return cmd.option("--base-url <url>", "Runner base URL", runnerBaseUrl()).option("--json", "Print raw JSON").option("-d, --description <text>", "Ground target by natural language").option("--label <text>", "Tap/focus by accessibility label (cleaned screen tree)").option("--id <text>", "Tap/focus by resource-id / accessibility id").option("--x <n>", "X in 0–1000", (v) => Number(v)).option("--y <n>", "Y in 0–1000", (v) => Number(v)).option("--x2 <n>", "End X in 0–1000", (v) => Number(v)).option("--y2 <n>", "End Y in 0–1000", (v) => Number(v)).option("--duration <ms>", "Gesture duration ms (long-press for tap)", (v) => Number(v)).option("--double", "Double-tap (tap only)").option("--text <text>", "Text to type").option("--app-id <id>", "Bundle id / application id").option("--url <url>", "URL to open").option("--seconds <n>", "Background seconds", (v) => Number(v)).option("--screenshot", "Wait for the screen to settle, then return the result screenshot (and a copy marking where the tap or swipe landed)").option("--settle <ms>", "With --screenshot: longest wait for the screen to settle (default 1500)", (v) => Number(v)).option("--full", "With --screenshot: return the raw Result screenshot instead of the Agent image").option("--scale <n>", "With --screenshot: Agent image scale 0.01–1 (default: long edge ~1000 px)", (v) => Number(v));
+  return cmd.option("--base-url <url>", "Runner base URL", runnerBaseUrl()).option("--json", "Print raw JSON").option("-d, --description <text>", "Ground target by natural language").option("--label <text>", "Tap/focus by accessibility label (cleaned screen tree)").option("--id <text>", "Tap/focus by resource-id / accessibility id").option("--x <n>", "X in 0–1000", (v) => Number(v)).option("--y <n>", "Y in 0–1000", (v) => Number(v)).option("--x2 <n>", "End X in 0–1000", (v) => Number(v)).option("--y2 <n>", "End Y in 0–1000", (v) => Number(v)).option("--duration <ms>", "Gesture duration ms (long-press for tap)", (v) => Number(v)).option("--double", "Double-tap (tap only)").option("--text <text>", "Text to type").option("--app-id <id>", "Bundle id / application id, or the Web URL on web").option("--url <url>", "URL to open").option("--seconds <n>", "Background seconds", (v) => Number(v)).option("--screenshot", "Wait for the screen to settle, then return the result screenshot (and a copy marking where the tap or swipe landed)").option("--settle <ms>", "With --screenshot: longest wait for the screen to settle (default 1500)", (v) => Number(v)).option("--full", "With --screenshot: return the raw Result screenshot instead of the Agent image").option("--scale <n>", "With --screenshot: Agent image scale 0.01–1 (default: long edge ~1000 px)", (v) => Number(v));
 }
 function printResultScreenshot(shot) {
   console.log(`screenshot ${shot.path}`);
@@ -17538,6 +17696,32 @@ addActionOptions(action.command("alert").description("Accept or dismiss a system
     fail("action alert", error);
   }
 });
+addActionOptions(action.command("key").description(`Press a key: ${KEY_NAMES.join(", ")}`).argument("<key>", "Key name, in any case").option("--modifiers <list>", `Held while the key is pressed, comma-separated: ${KEY_MODIFIERS.join(", ")}`)).action(async (keyName, options) => {
+  try {
+    const key = parseKeyName(keyName);
+    const modifiers = typeof options.modifiers === "string" ? parseKeyModifiers(options.modifiers) : [];
+    const body = await client(String(options.baseUrl)).performAction({
+      kind: "key",
+      key,
+      ...modifiers.length > 0 ? { modifiers } : {},
+      screenshot: options.screenshot === true ? true : undefined,
+      settleMs: options.settle,
+      fullImage: options.full === true ? true : undefined,
+      imageScale: options.scale
+    });
+    if (options.json) {
+      console.log(JSON.stringify(body, null, 2));
+      return;
+    }
+    console.log(`ok ${body.kind}`);
+    if (body.screenshot)
+      printResultScreenshot(body.screenshot);
+    if (body.phases)
+      printActionPhases(body.phases);
+  } catch (error) {
+    fail("action key", error);
+  }
+});
 addActionOptions(action.command("batch").description("Run known Actions from a JSON file or stdin (one Settle and Result screenshot at the end). Description-grounded steps are rejected.").argument("[file]", "JSON file of { steps: Action[] } or an Action array. Omit to read stdin.")).action(async (file, options) => {
   try {
     const raw = file ? await readFile2(file, "utf8") : await new Promise((resolve, reject) => {
@@ -17741,29 +17925,43 @@ signing.command("check").description("Sign YoqaRunner for a cabled iPhone now; r
     fail("signing check", error);
   }
 });
-var assertCmd = program2.command("assert").description("Assert text visibility on the active device");
+var assertCmd = program2.command("assert").description("Assert text or id visibility on the active device");
 for (const kind of ["visible", "not-visible"]) {
-  assertCmd.command(kind).description(kind === "visible" ? "Fail unless matching text appears in the cleaned screen tree" : "Fail if matching text is still present in the cleaned screen tree").option("--base-url <url>", "Runner base URL", runnerBaseUrl()).option("--json", "Print raw JSON").requiredOption("-t, --text <text>", "Text / label substring to match").option("--timeout <seconds>", "Seconds to wait before failing", (v) => Number(v), 5).action(async (options) => {
+  assertCmd.command(kind).description(kind === "visible" ? "Fail unless matching text or id appears in the cleaned screen tree" : "Fail if matching text or id is still present in the cleaned screen tree").option("--base-url <url>", "Runner base URL", runnerBaseUrl()).option("--json", "Print raw JSON").option("-t, --text <text>", "Text / label substring to match").option("--id <id>", "Element id to match, as a tap by id does (instead of --text)").option("--timeout <seconds>", "Seconds to wait before failing", (v) => Number(v), 5).action(async (options) => {
+    if (options.text == null === (options.id == null)) {
+      const usage = options.text != null ? "pass --text or --id, not both" : "pass --text <text> or --id <id>";
+      console.error(`yoqa assert ${kind} failed: ${usage}`);
+      process.exitCode = ASSERT_EXIT_CODE.couldNotCheck;
+      return;
+    }
+    const check = {
+      assertion: kind,
+      ...options.id != null ? { id: options.id } : { text: options.text },
+      timeoutMs: options.timeout * 1000
+    };
     try {
-      const line = formatAssertShellLine({
-        assertion: kind,
-        text: options.text,
-        timeoutSeconds: options.timeout
+      const c = client(options.baseUrl);
+      const { met } = await checkScreen({
+        ...check,
+        readScreen: () => c.getScreen(),
+        sleep: (ms) => new Promise((resolve) => setTimeout(resolve, ms)),
+        now: Date.now
       });
-      const result = await runYoqaShellScript(client(options.baseUrl), line);
+      const error = met ? undefined : screenCheckMissMessage(check);
+      if (!met)
+        process.exitCode = ASSERT_EXIT_CODE.notMet;
       if (options.json) {
-        console.log(JSON.stringify(result, null, 2));
-        if (!result.ok)
-          process.exitCode = 1;
+        console.log(JSON.stringify({ ok: met, completed: met ? 1 : 0, total: 1, error }, null, 2));
         return;
       }
-      if (!result.ok) {
-        fail(`assert ${kind}`, new Error(result.error ?? "assertion failed"));
+      if (error) {
+        console.error(`yoqa assert ${kind} failed: ${error}`);
         return;
       }
       console.log(`ok assert ${kind}`);
     } catch (error) {
       fail(`assert ${kind}`, error);
+      process.exitCode = ASSERT_EXIT_CODE.couldNotCheck;
     }
   });
 }
@@ -17783,10 +17981,14 @@ appsCmd.command("list").option("--base-url <url>", "Runner base URL", runnerBase
     fail("apps list", error);
   }
 });
-appsCmd.command("create").description("Create a local catalog app").requiredOption("--name <name>", "Display name").option("--prefix <prefix>", "CLI prefix (allocated from name when omitted)").option("--ios-bundle-id <id>", "iOS bundle id").option("--android-application-id <id>", "Android application id").option("--base-url <url>", "Runner base URL", runnerBaseUrl()).option("--json", "Print raw JSON").action(async (options) => {
+appsCmd.command("create").description("Create a local catalog app").requiredOption("--name <name>", "Display name").option("--prefix <prefix>", "CLI prefix (allocated from name when omitted)").option("--ios-bundle-id <id>", "iOS bundle id").option("--android-application-id <id>", "Android application id").option("--web-url <url>", "Web URL a Run on web opens (http or https)").option("--base-url <url>", "Runner base URL", runnerBaseUrl()).option("--json", "Print raw JSON").action(async (options) => {
   try {
     const c = client(options.baseUrl);
-    let app = await c.createApp({ name: options.name, prefix: options.prefix });
+    let app = await c.createApp({
+      name: options.name,
+      prefix: options.prefix,
+      webUrl: options.webUrl
+    });
     if (options.iosBundleId || options.androidApplicationId) {
       app = await c.updateApp(app.id, {
         iosBundleId: options.iosBundleId,
@@ -17817,11 +18019,12 @@ appsCmd.command("get").argument("<app>", "App prefix or id").option("--base-url
     console.log(`app_knowledge: ${app.knowledge || "(empty)"}`);
     console.log(`ios_bundle_id: ${app.iosBundleId || "(empty)"}`);
     console.log(`android_application_id: ${app.androidApplicationId || "(empty)"}`);
+    console.log(`web_url: ${app.webUrl || "(empty)"}`);
   } catch (error) {
     fail("apps get", error);
   }
 });
-appsCmd.command("update").argument("<app>", "App prefix or id").option("--base-url <url>", "Runner base URL", runnerBaseUrl()).option("--name <name>", "Display name").option("--prefix <prefix>", "CLI prefix").option("--context <text>", "App context / shared rules").option("--knowledge <text>", "App knowledge notes injected into agent runs").option("--ios-bundle-id <id>", "iOS bundle id").option("--android-application-id <id>", "Android application id").option("--json", "Print raw JSON").action(async (appArg, options) => {
+appsCmd.command("update").argument("<app>", "App prefix or id").option("--base-url <url>", "Runner base URL", runnerBaseUrl()).option("--name <name>", "Display name").option("--prefix <prefix>", "CLI prefix").option("--context <text>", "App context / shared rules").option("--knowledge <text>", "App knowledge notes injected into agent runs").option("--ios-bundle-id <id>", "iOS bundle id").option("--android-application-id <id>", "Android application id").option("--web-url <url>", "Web URL a Run on web opens (empty clears it)").option("--json", "Print raw JSON").action(async (appArg, options) => {
   try {
     const c = client(options.baseUrl);
     const resolved = await resolveAppId(c, appArg);
@@ -17831,7 +18034,8 @@ appsCmd.command("update").argument("<app>", "App prefix or id").option("--base-u
       context: options.context,
       knowledge: options.knowledge,
       iosBundleId: options.iosBundleId,
-      androidApplicationId: options.androidApplicationId
+      androidApplicationId: options.androidApplicationId,
+      webUrl: options.webUrl
     });
     if (options.json) {
       console.log(JSON.stringify(app, null, 2));
@@ -18155,7 +18359,7 @@ runsCmd.command("delete").argument("<runId>", "Run id").option("--base-url <url>
     fail("runs delete", error);
   }
 });
-runsCmd.command("create").argument("<app>", "App prefix or id").requiredOption("--cases <numbers>", "Comma-separated case numbers, e.g. 1,2,5").option("--device <id>", "Device id (defaults to active session)").option("--platform <platform>", "ios | android (defaults to active session)").option("--build-id <id>", "Registered build id to install before run").option("--build-path <path>", "Absolute build path to register + install").option("--mode <mode>", "auto | script | agent (default: auto)").option("--screen-mode <mode>", "vision | tree — what the agent sees: screenshot only, or also the accessibility tree (default: vision)").option("--lane <lane>", "direct | auto").option("--record-video", "Record a screen video of every case in the run, even cases not set to record").option("--base-url <url>", "Runner base URL", runnerBaseUrl()).option("--json", "Print raw JSON").option("--wait", "Wait until the run finishes (passed / errored / cancelled)").option("--timeout <seconds>", "Wait timeout in seconds (default: 1800)", String(DEFAULT_RUN_WAIT_TIMEOUT_SECONDS)).option("--github-output", "Write run_id and status to $GITHUB_OUTPUT").option("--no-github-output", "Do not write GitHub step outputs").action(async (appArg, options) => {
+runsCmd.command("create").argument("<app>", "App prefix or id").requiredOption("--cases <numbers>", "Comma-separated case numbers, e.g. 1,2,5").option("--device <id>", "Device id (defaults to active session)").option("--platform <platform>", "ios | android | web (web for web-* and chromium-cdp-<port>; defaults to active session)").option("--build-id <id>", "Registered build id to install before run").option("--build-path <path>", "Absolute build path to register + install").option("--mode <mode>", "auto | script | agent (default: auto)").option("--screen-mode <mode>", "vision | tree — what the agent sees: screenshot only, or also the accessibility tree (default: vision)").option("--lane <lane>", "direct | auto").option("--record-video", "Record a screen video of every case in the run, even cases not set to record").option("--base-url <url>", "Runner base URL", runnerBaseUrl()).option("--json", "Print raw JSON").option("--wait", "Wait until the run finishes (passed / errored / cancelled)").option("--timeout <seconds>", "Wait timeout in seconds (default: 1800)", String(DEFAULT_RUN_WAIT_TIMEOUT_SECONDS)).option("--github-output", "Write run_id and status to $GITHUB_OUTPUT").option("--no-github-output", "Do not write GitHub step outputs").action(async (appArg, options) => {
   try {
     const c = client(options.baseUrl);
     const resolved = await resolveAppId(c, appArg);
@@ -18171,18 +18375,16 @@ runsCmd.command("create").argument("<app>", "App prefix or id").requiredOption("
       caseIds.push(found.id);
     }
     let deviceId = options.device;
-    let platform = options.platform;
-    if (!deviceId || !platform) {
+    let platformOption = options.platform ?? (deviceId && isWebDeviceId(deviceId) ? "web" : undefined);
+    if (!deviceId || !platformOption) {
       const active = await c.getActiveDevice();
       if (!active) {
         throw new Error("No --device/--platform and no active session. Connect first or pass both flags.");
       }
       deviceId = deviceId ?? active.deviceId;
-      platform = platform ?? active.platform;
-    }
-    if (platform !== "ios" && platform !== "android") {
-      throw new Error("--platform must be ios or android");
+      platformOption = platformOption ?? active.platform;
     }
+    const platform = parsePlatform(platformOption);
     const executionMode = options.mode === "script" || options.mode === "agent" || options.mode === "auto" ? options.mode : undefined;
     if (options.mode && !executionMode) {
       throw new Error("--mode must be auto, script, or agent");
@@ -18269,23 +18471,26 @@ scriptCmd.command("run").argument("<file>", "Path to a Case Script file (.yoqa.y
     }
     const result = await runCaseScript(c, script, {
       pauseAfterActionMs: 800,
-      onStep: ({ index, total, action: action2, status, error, response }) => {
+      onStep: (event) => {
+        const { position, total, action: action2, status, error, response, outcome } = event;
         if (status === "running")
           return;
-        const step = index + 1;
+        const step = position + 1;
         if (options.json) {
           console.log(JSON.stringify({
             ok: status === "ok",
             status,
             type: action2.type,
             step,
+            path: event.path,
             command: caseScriptActionCommand(action2),
+            ...outcome ? { outcome } : {},
             ...error ? { error } : {},
             ...response ? { response } : {}
           }, null, 2));
           return;
         }
-        const line = formatCaseScriptFileAction(action2);
+        const line = formatCaseScriptReplayStep(event);
         if (status === "ok")
           console.log(`ok ${line} (${step}/${total})`);
         else if (status === "error")
@@ -18295,10 +18500,11 @@ scriptCmd.command("run").argument("<file>", "Path to a Case Script file (.yoqa.y
       }
     });
     if (!result.ok) {
-      throw new Error(`action ${(result.failedIndex ?? 0) + 1}/${result.total} failed: ${result.error ?? "failed"}`);
+      const where = result.failedPath ? formatCaseScriptStepPath(result.failedPath) : `action ${(result.failedIndex ?? 0) + 1}`;
+      throw new Error(`${where} failed: ${result.error ?? "failed"}`);
     }
     if (!options.json) {
-      console.log(`done ${result.total} action${result.total === 1 ? "" : "s"}`);
+      console.log(`done ${result.total} step${result.total === 1 ? "" : "s"}`);
     }
   } catch (error) {
     fail("script run", error);
@@ -18335,10 +18541,9 @@ scriptCmd.command("export").argument("<app>", "App prefix or id").argument("<num
 });
 program2.command("benchmark").description("Compare Yoqa (and Argent, when installed) tap-to-result latency on one device").requiredOption("--device <id>", "Device UDID / serial").requiredOption("--platform <platform>", "ios | android").option("--repeats <n>", "Tap-to-result repeats (default: suite repeats)", (v) => Number(v)).option("--suite <path>", "Versioned suite JSON (default: built-in v1)").option("--tools <list>", "Comma-separated: yoqa,argent (default: yoqa)", "yoqa").option("--lane <lane>", "Yoqa Lane: direct | auto", "auto").option("--arms <list>", "Yoqa Screen arms: vision,tree (default: suite arms)").option("--app <id>", "Catalog App id for Case arms (required when the suite has cases)").option("--out <path>", "Write the JSON report to this path").option("--base-url <url>", "Runner base URL", runnerBaseUrl()).option("--json", "Print JSON instead of the table").action(async (options) => {
   try {
-    const platform = options.platform;
-    if (platform !== "ios" && platform !== "android") {
-      throw new Error("--platform must be ios or android");
-    }
+    const platform = parsePlatform(options.platform);
+    if (platform === "web")
+      throw new Error("benchmark runs on ios or android only");
     const lane = options.lane === "direct" || options.lane === "auto" ? options.lane : undefined;
     if (options.lane && !lane)
       throw new Error("--lane must be direct or auto");