@yoqa/cli 0.3.24 → 0.3.26

package/dist/main.js

@@ -6299,6 +6299,8 @@ var caseScriptTapSchema = exports_external.object({
   y: exports_external.number().min(0).max(1000).optional(),
   label: exports_external.string().min(1).optional(),
   id: exports_external.string().min(1).optional(),
+  double: exports_external.boolean().optional(),
+  durationMs: exports_external.number().min(50).max(5000).optional(),
   reason: exports_external.string().optional()
 }).superRefine((value, ctx) => {
   const hasCoords = value.x != null && value.y != null;
@@ -6309,8 +6311,45 @@ var caseScriptTapSchema = exports_external.object({
     });
   }
 });
+var caseScriptSwipeSchema = exports_external.object({
+  type: exports_external.literal("swipe"),
+  x: exports_external.number().min(0).max(1000),
+  y: exports_external.number().min(0).max(1000),
+  x2: exports_external.number().min(0).max(1000),
+  y2: exports_external.number().min(0).max(1000),
+  durationMs: exports_external.number().min(50).max(5000).optional(),
+  reason: exports_external.string().optional()
+});
+var caseScriptDragSchema = exports_external.object({
+  type: exports_external.literal("drag"),
+  x: exports_external.number().min(0).max(1000),
+  y: exports_external.number().min(0).max(1000),
+  x2: exports_external.number().min(0).max(1000),
+  y2: exports_external.number().min(0).max(1000),
+  durationMs: exports_external.number().min(50).max(5000).optional(),
+  reason: exports_external.string().optional()
+});
+var caseScriptAppIdSchema = exports_external.union([
+  exports_external.object({
+    type: exports_external.literal("activate-app"),
+    appId: exports_external.string().min(1),
+    reason: exports_external.string().optional()
+  }),
+  exports_external.object({
+    type: exports_external.literal("terminate-app"),
+    appId: exports_external.string().min(1),
+    reason: exports_external.string().optional()
+  }),
+  exports_external.object({
+    type: exports_external.literal("restart-app"),
+    appId: exports_external.string().min(1),
+    reason: exports_external.string().optional()
+  })
+]);
 var caseScriptActionSchema = exports_external.union([
   caseScriptTapSchema,
+  caseScriptSwipeSchema,
+  caseScriptDragSchema,
   exports_external.object({
     type: exports_external.literal("type"),
     text: exports_external.string(),
@@ -6332,6 +6371,17 @@ var caseScriptActionSchema = exports_external.union([
     type: exports_external.literal("alert"),
     alertAction: exports_external.union([exports_external.literal("accept"), exports_external.literal("dismiss")]).default("accept"),
     reason: exports_external.string().optional()
+  }),
+  caseScriptAppIdSchema,
+  exports_external.object({
+    type: exports_external.literal("background-app"),
+    seconds: exports_external.number().min(0).max(120).optional(),
+    reason: exports_external.string().optional()
+  }),
+  exports_external.object({
+    type: exports_external.literal("open-url"),
+    url: exports_external.string().min(1),
+    reason: exports_external.string().optional()
   })
 ]);
 var caseScriptSchema = exports_external.object({
@@ -6588,6 +6638,7 @@ var runStepSchema = exports_external.object({
   ok: exports_external.boolean(),
   latencyMs: exports_external.number().nonnegative(),
   detail: exports_external.string().nullable(),
+  command: exports_external.string().nullable().optional(),
   createdAt: exports_external.number().int().nonnegative()
 });
 var runTestSchema = exports_external.object({
@@ -6599,6 +6650,7 @@ var runTestSchema = exports_external.object({
   error: exports_external.string().nullable(),
   startedAt: exports_external.number().int().nonnegative().nullable(),
   finishedAt: exports_external.number().int().nonnegative().nullable(),
+  currentCommand: exports_external.string().nullable().optional(),
   steps: exports_external.array(runStepSchema).optional()
 });
 var runSchema = exports_external.object({
@@ -6817,758 +6869,940 @@ function pickLatestRun(runs) {
     return null;
   return runs.reduce((best, run) => run.createdAt > best.createdAt ? run : best);
 }
-// ../runner-client/src/run-report.ts
-function actionSummary(action) {
-  if (!action || typeof action !== "object")
-    return "Step";
-  const record = action;
-  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";
-  }
-  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";
+// ../runner-client/src/xml-entities.ts
+var NAMED = {
+  amp: "&",
+  lt: "<",
+  gt: ">",
+  quot: '"',
+  apos: "'"
+};
+function decodeXmlEntities(value) {
+  return value.replace(/&(#x[0-9a-fA-F]+|#\d+|[a-zA-Z][a-zA-Z0-9]+);/g, (entity, body) => {
+    if (body.startsWith("#")) {
+      const code = body[1] === "x" || body[1] === "X" ? Number.parseInt(body.slice(2), 16) : Number.parseInt(body.slice(1), 10);
+      if (!Number.isFinite(code) || code < 0 || code > 1114111) {
+        return entity;
+      }
+      try {
+        return String.fromCodePoint(code);
+      } catch {
+        return entity;
+      }
+    }
+    return NAMED[body] ?? entity;
+  });
+}
+
+// ../runner-client/src/shell-script.ts
+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 (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}`;
+  if (quote != null) {
+    throw new Error("Unclosed quote");
   }
-  if (type === "verify")
-    return "Verify";
-  if (type === "done")
-    return "Done";
-  if (type === "fail")
-    return "Failed";
-  if (type === "swipe")
-    return "Swipe";
-  if (type === "input") {
-    return `Input${typeof record.text === "string" ? `: ${record.text}` : ""}`;
+  if (current.length > 0) {
+    tokens.push(current);
   }
-  return type.charAt(0).toUpperCase() + type.slice(1);
-}
-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 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,
-    detail: step.detail,
-    reason,
-    thoughts,
-    screenshotBase64: screenshotsByStepId[step.id] ?? null
-  };
+  return tokens;
 }
-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 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);
+    }
   }
-  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,
-    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";
-}
-function escapeHtml(value) {
-  return value.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;").replace(/'/g, "&#39;");
+  return flags;
 }
-function formatWhen(ms) {
-  if (ms == null)
-    return "—";
-  return new Date(ms).toLocaleString();
+function flagString(flags, ...names) {
+  for (const name of names) {
+    const value = flags.get(name);
+    if (typeof value === "string")
+      return value;
+  }
+  return;
 }
-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 flagNumber(flags, ...names) {
+  const raw = flagString(flags, ...names);
+  if (raw == null)
+    return;
+  const n = Number(raw);
+  return Number.isFinite(n) ? n : undefined;
 }
-function statusAccent(status) {
-  if (status === "passed") {
-    return { bg: "#dcfce7", fg: "#166534", label: "Passed" };
+function parseActionFromTokens(tokens, lineNumber, raw) {
+  if (tokens[0] !== "yoqa" || tokens[1] !== "action") {
+    throw new Error("Expected `yoqa action <kind> …`");
   }
-  if (status === "errored") {
-    return { bg: "#fee2e2", fg: "#991b1b", label: "Failed" };
+  const kindRaw = tokens[2];
+  if (!kindRaw) {
+    throw new Error("Missing action kind");
   }
-  return { bg: "#e5e7eb", fg: "#374151", label: "Cancelled" };
+  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 pngDataUri(base64) {
-  return `data:image/png;base64,${base64}`;
+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 formatRunReportHtml(doc) {
-  const accent = statusAccent(doc.status);
-  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 ?? "—"],
-    ["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>` : "";
-      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>
-  ${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; }
-  .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; }
+function parseAssertFromTokens(tokens, lineNumber, raw) {
+  if (tokens[0] !== "yoqa" || tokens[1] !== "assert") {
+    throw new Error("Expected `yoqa assert <visible|not-visible> …`");
   }
-</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>
-`;
+  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 escapeMd(value) {
-  return value.replace(/\|/g, "\\|").replace(/\r?\n/g, " ");
+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 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 ?? "—")} |`,
-    `| 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.latencyMs != null)
-        lines.push(`- Latency: ${step.latencyMs}ms`);
-      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>");
+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 (step.screenshotBase64) {
-        lines.push("", `![Step ${step.index} screenshot](${pngDataUri(step.screenshotBase64)})`);
-      } else {
-        lines.push("", "_No screenshot_");
+      if (tokens[0] === "yoqa" && tokens[1] === "assert") {
+        steps.push(parseAssertFromTokens(tokens, lineNumber, trimmed));
+        continue;
       }
-      lines.push("");
+      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)
+      });
     }
-  });
-  lines.push("---", "", "_Generated by Yoqa_", "");
-  return lines.join(`
-`);
+  }
+  return { steps, errors: errors2 };
 }
-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 ?? "—")} |`,
-    `| Duration | ${escapeMd(formatDuration(doc.startedAt ?? doc.createdAt, doc.finishedAt))} |`,
-    `| Run ID | \`${doc.id}\` |`,
-    ""
-  ];
-  if (doc.error) {
-    lines.push(`> **Error:** ${doc.error}`, "");
+function formatActionShellLine(action) {
+  const parts = ["yoqa", "action", action.kind];
+  if (action.id) {
+    parts.push("--id", shellSingleQuote(action.id));
+  }
+  if (action.label) {
+    parts.push("--label", shellSingleQuote(action.label));
+  }
+  if (action.description) {
+    parts.push("-d", shellSingleQuote(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", 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");
   }
-  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("");
+  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", shellSingleQuote(input.text.trim())];
+  const timeout = input.timeoutSeconds ?? 5;
+  if (timeout !== 5) {
+    parts.push("--timeout", String(timeout));
   }
-  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.reason)
-        lines.push(`  - Reason: ${escapeMd(step.reason)}`);
-      if (step.detail && step.detail !== step.reason) {
-        lines.push(`  - Detail: ${escapeMd(step.detail)}`);
-      }
+  return parts.join(" ");
+}
+var DEFAULT_SHELL_SCRIPT_HEADER = [
+  "#!/usr/bin/env bash",
+  "# Yoqa inspector script",
+  "# Requires an active device session: yoqa devices connect <id>",
+  "set -euo pipefail",
+  ""
+].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;
     }
-    lines.push("");
+    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();
+}
+function screenHasText(elements, text) {
+  const needle = normalizedLabel(text);
+  if (!needle)
+    return false;
+  return (elements ?? []).some((el) => {
+    const label = normalizedLabel(el.label);
+    const type = el.type?.toLowerCase() ?? "";
+    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);
   }
-  lines.push("Download the `yoqa-report` artifact for the full HTML report with screenshots.", "");
-  return lines.join(`
-`);
 }
-// ../runner-client/src/xml-entities.ts
-var NAMED = {
-  amp: "&",
-  lt: "<",
-  gt: ">",
-  quot: '"',
-  apos: "'"
-};
-function decodeXmlEntities(value) {
-  return value.replace(/&(#x[0-9a-fA-F]+|#\d+|[a-zA-Z][a-zA-Z0-9]+);/g, (entity, body) => {
-    if (body.startsWith("#")) {
-      const code = body[1] === "x" || body[1] === "X" ? Number.parseInt(body.slice(2), 16) : Number.parseInt(body.slice(1), 10);
-      if (!Number.isFinite(code) || code < 0 || code > 1114111) {
-        return entity;
-      }
-      try {
-        return String.fromCodePoint(code);
-      } catch {
-        return entity;
-      }
+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 };
+  }
+  for (let index = 0;index < steps.length; index++) {
+    if (options.signal?.aborted) {
+      return { ok: false, completed: index, total, error: "Aborted" };
     }
-    return NAMED[body] ?? entity;
-  });
-}
-
-// ../runner-client/src/shell-script.ts
-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)
+    const step = steps[index];
+    if (!step)
       continue;
-    if (quote === "'") {
-      if (ch === "'") {
-        quote = null;
+    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 {
-        current += ch;
-      }
-      continue;
-    }
-    if (quote === '"') {
-      if (ch === "\\") {
-        const next = line[i + 1];
-        if (next != null) {
-          current += next;
-          i++;
+        await client.performAction(step.action);
+        if (options.pauseAfterActionMs) {
+          await sleepMs(options.pauseAfterActionMs, options.signal);
         }
-        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;
+      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 });
+      return {
+        ok: false,
+        completed: index,
+        total,
+        error: `Line ${step.lineNumber}: ${message}`
+      };
     }
-    current += ch;
   }
-  if (quote != null) {
-    throw new Error("Unclosed quote");
+  return { ok: true, completed: total, total };
+}
+
+// ../runner-client/src/run-report.ts
+function actionSummary(action) {
+  if (!action || typeof action !== "object")
+    return "Step";
+  const record = action;
+  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";
   }
-  if (current.length > 0) {
-    tokens.push(current);
+  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";
   }
-  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 (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}`;
+  }
+  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";
   }
-  return flags;
-}
-function flagString(flags, ...names) {
-  for (const name of names) {
-    const value = flags.get(name);
-    if (typeof value === "string")
-      return value;
+  if (type === "input") {
+    return `Input${typeof record.text === "string" ? `: ${record.text}` : ""}`;
   }
-  return;
+  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";
+  }
+  return type.charAt(0).toUpperCase() + type.slice(1);
 }
-function flagNumber(flags, ...names) {
-  const raw = flagString(flags, ...names);
-  if (raw == null)
-    return;
-  const n = Number(raw);
-  return Number.isFinite(n) ? n : undefined;
+function optionalTrimmedString(value) {
+  return typeof value === "string" && value.trim() ? value.trim() : undefined;
 }
-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}`);
+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);
   }
-  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";
+  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 } : {}
+    });
   }
-  return { kind: "action", action, lineNumber, raw };
+  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;
+  }
+  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 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,
+    detail: step.detail,
+    reason,
+    thoughts,
+    command: step.command ?? formatStepCommand(step.action),
+    screenshotBase64: screenshotsByStepId[step.id] ?? null
+  };
 }
-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");
+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 path = pathToken?.trim() ? pathToken.trim() : null;
-  return { kind: "screenshot", path, lineNumber, raw };
+  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,
+    error: run.error,
+    createdAt: run.createdAt,
+    startedAt: run.startedAt,
+    finishedAt: run.finishedAt,
+    tests
+  };
 }
-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");
+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";
+}
+function escapeHtml(value) {
+  return value.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;").replace(/'/g, "&#39;");
+}
+function formatWhen(ms) {
+  if (ms == null)
+    return "—";
+  return new Date(ms).toLocaleString();
+}
+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" };
   }
-  const timeout = flagNumber(flags, "--timeout") ?? 5;
-  if (timeout < 0) {
-    throw new Error("--timeout must be non-negative");
+  if (status === "errored") {
+    return { bg: "#fee2e2", fg: "#991b1b", label: "Failed" };
   }
-  return {
-    kind: "assert",
-    assertion: assertionRaw,
-    text: text.trim(),
-    timeoutSeconds: timeout,
-    lineNumber,
-    raw
-  };
+  return { bg: "#e5e7eb", fg: "#374151", label: "Cancelled" };
 }
-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 pngDataUri(base64) {
+  return `data:image/png;base64,${base64}`;
 }
-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)
-      });
-    }
+function formatRunReportHtml(doc) {
+  const accent = statusAccent(doc.status);
+  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 ?? "—"],
+    ["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 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}
+  ${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 { steps, errors: errors2 };
+</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 formatAssertShellLine(input) {
-  const parts = ["yoqa", "assert", input.assertion, "--text", shellSingleQuote(input.text.trim())];
-  const timeout = input.timeoutSeconds ?? 5;
-  if (timeout !== 5) {
-    parts.push("--timeout", String(timeout));
-  }
-  return parts.join(" ");
+function escapeMd(value) {
+  return value.replace(/\|/g, "\\|").replace(/\r?\n/g, " ");
 }
-var DEFAULT_SHELL_SCRIPT_HEADER = [
-  "#!/usr/bin/env bash",
-  "# Yoqa inspector script",
-  "# Requires an active device session: yoqa devices connect <id>",
-  "set -euo pipefail",
-  ""
-].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" }));
+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 ?? "—")} |`,
+    `| 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(Object.assign(new Error("Aborted"), { name: "AbortError" }));
-    };
-    signal?.addEventListener("abort", onAbort, { once: true });
-  });
-}
-function normalizedLabel(value) {
-  return decodeXmlEntities(value ?? "").trim().toLowerCase();
-}
-function screenHasText(elements, text) {
-  const needle = normalizedLabel(text);
-  if (!needle)
-    return false;
-  return (elements ?? []).some((el) => {
-    const label = normalizedLabel(el.label);
-    const type = el.type?.toLowerCase() ?? "";
-    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}`);
+    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.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("");
     }
-    await sleepMs(400, signal);
-  }
+  });
+  lines.push("---", "", "_Generated by Yoqa_", "");
+  return lines.join(`
+`);
 }
-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}`
-    };
+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 ?? "—")} |`,
+    `| Duration | ${escapeMd(formatDuration(doc.startedAt ?? doc.createdAt, doc.finishedAt))} |`,
+    `| Run ID | \`${doc.id}\` |`,
+    ""
+  ];
+  if (doc.error) {
+    lines.push(`> **Error:** ${doc.error}`, "");
   }
-  const { steps } = parsed;
-  const total = steps.length;
-  if (total === 0) {
-    return { ok: true, completed: 0, total: 0 };
+  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("");
   }
-  for (let index = 0;index < steps.length; index++) {
-    if (options.signal?.aborted) {
-      return { ok: false, completed: index, total, error: "Aborted" };
-    }
-    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);
-        }
+  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 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 });
-      return {
-        ok: false,
-        completed: index,
-        total,
-        error: `Line ${step.lineNumber}: ${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";
@@ -8043,7 +8277,7 @@ var {
 // package.json
 var package_default = {
   name: "@yoqa/cli",
-  version: "0.3.24",
+  version: "0.3.26",
   description: "Yoqa CLI — drive local mobile QA from the terminal or CI (talks to the Yoqa runner over HTTP)",
   license: "UNLICENSED",
   type: "module",
@@ -8081,7 +8315,7 @@ var package_default = {
     health: "bun run src/main.ts health"
   },
   dependencies: {
-    "@yoqa/runner": "0.3.24"
+    "@yoqa/runner": "0.3.26"
   },
   devDependencies: {
     "@types/node": "^22.15.30",
@@ -9823,18 +10057,80 @@ scriptCmd.command("run").argument("<file>", "Path to a .yoqa.json / CaseScript J
         await sleep(800);
         continue;
       }
+      if (action2.type === "swipe" || action2.type === "drag") {
+        const body2 = await c.performAction({
+          kind: action2.type,
+          x: action2.x,
+          y: action2.y,
+          x2: action2.x2,
+          y2: action2.y2,
+          durationMs: action2.durationMs
+        });
+        if (options.json) {
+          console.log(JSON.stringify({ ...body2, step: idx }, null, 2));
+        } else {
+          console.log(`ok ${body2.kind} (${idx}/${script.actions.length})`);
+        }
+        await sleep(800);
+        continue;
+      }
+      if (action2.type === "activate-app" || action2.type === "terminate-app" || action2.type === "restart-app") {
+        const body2 = await c.performAction({ kind: action2.type, appId: action2.appId });
+        if (options.json) {
+          console.log(JSON.stringify({ ...body2, step: idx }, null, 2));
+        } else {
+          console.log(`ok ${body2.kind} (${idx}/${script.actions.length})`);
+        }
+        await sleep(800);
+        continue;
+      }
+      if (action2.type === "background-app") {
+        const body2 = await c.performAction({
+          kind: "background-app",
+          seconds: action2.seconds
+        });
+        if (options.json) {
+          console.log(JSON.stringify({ ...body2, step: idx }, null, 2));
+        } else {
+          console.log(`ok ${body2.kind} (${idx}/${script.actions.length})`);
+        }
+        await sleep(800);
+        continue;
+      }
+      if (action2.type === "open-url") {
+        const body2 = await c.performAction({ kind: "open-url", url: action2.url });
+        if (options.json) {
+          console.log(JSON.stringify({ ...body2, step: idx }, null, 2));
+        } else {
+          console.log(`ok ${body2.kind} (${idx}/${script.actions.length})`);
+        }
+        await sleep(800);
+        continue;
+      }
+      if (action2.type === "type") {
+        const body2 = await c.performAction({ kind: "input", text: action2.text });
+        if (options.json) {
+          console.log(JSON.stringify({ ...body2, step: idx }, null, 2));
+        } else {
+          console.log(`ok ${body2.kind} (${idx}/${script.actions.length})`);
+        }
+        await sleep(800);
+        continue;
+      }
       const tapBody = { kind: "tap" };
-      if (action2.type === "tap") {
-        if (action2.label)
-          tapBody.label = action2.label;
-        if (action2.id)
-          tapBody.id = action2.id;
-        if (action2.x != null)
-          tapBody.x = action2.x;
-        if (action2.y != null)
-          tapBody.y = action2.y;
-      }
-      const body = action2.type === "tap" ? await c.performAction(tapBody) : await c.performAction({ kind: "input", text: action2.text });
+      if (action2.label)
+        tapBody.label = action2.label;
+      if (action2.id)
+        tapBody.id = action2.id;
+      if (action2.x != null)
+        tapBody.x = action2.x;
+      if (action2.y != null)
+        tapBody.y = action2.y;
+      if (action2.double)
+        tapBody.double = true;
+      if (action2.durationMs != null)
+        tapBody.durationMs = action2.durationMs;
+      const body = await c.performAction(tapBody);
       if (options.json) {
         console.log(JSON.stringify({ ...body, step: idx }, null, 2));
       } else {