prowl-tools 0.1.5 → 0.1.6

package/dist/index.cjs

@@ -59,7 +59,7 @@ var init_hunt_name = __esm({
 });
 
 // src/config/schema.ts
-var import_zod, webTargetSchema, macosTargetSchema, androidTargetSchema, iosTargetSchema, targetSchema, configSchema, navigateStepSchema, clickStepSchema, singleKeyValueSchema, fillStepSchema, typeStepSchema, pressStepSchema, waitForSelectorStepSchema, waitStepSchema, waitForUrlStepSchema, waitForNetworkIdleStepSchema, selectOptionStepSchema, selectStepSchema, onDialogStepSchema, setInputFilesStepSchema, inlineAssertStepSchema, runHuntStepSchema, hoverStepSchema, scrollStepSchema, scrollToStepSchema, screenshotStepSchema, ifStepSchema, repeatStepSchema, mockRouteStepSchema, unmockRouteStepSchema, evalScriptStepSchema, runScriptStepSchema, assertScreenshotStepSchema, copyTextStepSchema, waitForDownloadStepSchema, stepSchema, assertionSchema, huntSchema;
+var import_zod, webTargetSchema, macosTargetSchema, androidTargetSchema, iosTargetSchema, targetSchema, configSchema, navigateStepSchema, clickStepSchema, singleKeyValueSchema, fillStepSchema, typeStepSchema, pressStepSchema, waitForSelectorStepSchema, waitStepSchema, waitForUrlStepSchema, waitForNetworkIdleStepSchema, selectOptionStepSchema, selectStepSchema, onDialogStepSchema, setInputFilesStepSchema, inlineAssertStepSchema, runHuntStepSchema, hoverStepSchema, scrollStepSchema, scrollToStepSchema, screenshotStepSchema, ifStepSchema, repeatStepSchema, mockRouteStepSchema, unmockRouteStepSchema, evalScriptStepSchema, runScriptStepSchema, assertScreenshotStepSchema, assertWithAiStepSchema, copyTextStepSchema, waitForDownloadStepSchema, stepSchema, assertionSchema, huntSchema;
 var init_schema = __esm({
   "src/config/schema.ts"() {
     "use strict";
@@ -311,6 +311,9 @@ var init_schema = __esm({
         threshold: import_zod.z.number().min(0).max(1).optional()
       }).strict()
     }).strict();
+    assertWithAiStepSchema = import_zod.z.object({
+      assertWithAI: import_zod.z.string().min(1)
+    }).strict();
     copyTextStepSchema = import_zod.z.object({
       copyText: import_zod.z.object({
         selector: import_zod.z.string().min(1),
@@ -353,6 +356,7 @@ var init_schema = __esm({
       evalScriptStepSchema,
       runScriptStepSchema,
       assertScreenshotStepSchema,
+      assertWithAiStepSchema,
       copyTextStepSchema,
       waitForDownloadStepSchema
     ]);
@@ -716,7 +720,7 @@ var import_commander13 = require("commander");
 // package.json
 var package_default = {
   name: "prowl-tools",
-  version: "0.1.5",
+  version: "0.1.6",
   description: "CLI-first QA testing tool for deterministic Playwright flows.",
   type: "module",
   license: "Apache-2.0",
@@ -1105,6 +1109,11 @@ function interpolateStep(step, vars, stepPath2, redacted) {
       }
     };
   }
+  if ("assertWithAI" in step) {
+    return {
+      assertWithAI: interpolateString(step.assertWithAI, vars).value
+    };
+  }
   if ("copyText" in step) {
     return {
       copyText: {
@@ -1987,6 +1996,213 @@ var import_node_path5 = __toESM(require("path"), 1);
 
 // src/browser/android-driver.ts
 var import_node_fs5 = __toESM(require("fs"), 1);
+
+// src/analyzer/xml.ts
+var ENTITIES = {
+  amp: "&",
+  lt: "<",
+  gt: ">",
+  quot: '"',
+  apos: "'"
+};
+function decodeXmlEntities(value) {
+  if (!value.includes("&")) {
+    return value;
+  }
+  return value.replace(/&(#(?:[xX][0-9a-fA-F]+|[0-9]+)|[a-zA-Z]+);/g, (match, code) => {
+    if (code[0] === "#") {
+      const hex = code[1] === "x" || code[1] === "X";
+      const num2 = Number.parseInt(code.slice(hex ? 2 : 1), hex ? 16 : 10);
+      return Number.isSafeInteger(num2) && num2 <= 1114111 ? String.fromCodePoint(num2) : match;
+    }
+    const named = ENTITIES[code];
+    return named ?? match;
+  });
+}
+var ATTR_RE = /([^\s=/]+)\s*=\s*("([^"]*)"|'([^']*)')/g;
+function parseTagBody(body) {
+  const trimmed = body.trim();
+  const nameMatch = /^([^\s/>]+)/.exec(trimmed);
+  const tag = nameMatch ? nameMatch[1] : "";
+  const attrs = {};
+  const rest = trimmed.slice(tag.length);
+  ATTR_RE.lastIndex = 0;
+  let m;
+  while ((m = ATTR_RE.exec(rest)) !== null) {
+    const rawValue = m[3] !== void 0 ? m[3] : m[4] ?? "";
+    attrs[m[1]] = decodeXmlEntities(rawValue);
+  }
+  return { tag, attrs };
+}
+function parseXml(input) {
+  const n = input.length;
+  const stack = [];
+  let root = null;
+  let i = 0;
+  while (i < n) {
+    const lt = input.indexOf("<", i);
+    if (lt < 0) {
+      break;
+    }
+    i = lt + 1;
+    const ch = input[i];
+    if (ch === "?") {
+      const end = input.indexOf("?>", i);
+      i = end < 0 ? n : end + 2;
+      continue;
+    }
+    if (ch === "!") {
+      if (input.startsWith("!--", i)) {
+        const end = input.indexOf("-->", i);
+        i = end < 0 ? n : end + 3;
+      } else {
+        const end = input.indexOf(">", i);
+        i = end < 0 ? n : end + 1;
+      }
+      continue;
+    }
+    if (ch === "/") {
+      const gt = input.indexOf(">", i);
+      i = gt < 0 ? n : gt + 1;
+      stack.pop();
+      continue;
+    }
+    let j = i;
+    let quote2 = null;
+    while (j < n) {
+      const c = input[j];
+      if (quote2 !== null) {
+        if (c === quote2) {
+          quote2 = null;
+        }
+      } else if (c === '"' || c === "'") {
+        quote2 = c;
+      } else if (c === ">") {
+        break;
+      }
+      j += 1;
+    }
+    const inner = input.slice(i, j);
+    i = j + 1;
+    const selfClose = inner.endsWith("/");
+    const body = selfClose ? inner.slice(0, -1) : inner;
+    const { tag, attrs } = parseTagBody(body);
+    if (tag.length === 0) {
+      continue;
+    }
+    const element = { tag, attrs, children: [] };
+    const parent = stack[stack.length - 1];
+    if (parent) {
+      parent.children.push(element);
+    }
+    if (root === null) {
+      root = element;
+    }
+    if (!selfClose) {
+      stack.push(element);
+    }
+  }
+  return root;
+}
+
+// src/selector/native.ts
+function unquoteSelectorValue(value) {
+  const trimmed = value.trim();
+  const first = trimmed[0];
+  if ((first === '"' || first === "'") && trimmed.endsWith(first) && trimmed.length >= 2) {
+    return trimmed.slice(1, -1);
+  }
+  return trimmed;
+}
+function quoteSelectorValue(value) {
+  return `"${value}"`;
+}
+var ROLE_SELECTOR_RE = /^role=([A-Za-z][\w.$-]*)(?:\[name=(.+)\])?$/s;
+var NATIVE_SELECTOR_PREFIX_RE = /^(id|label|text|role)=/;
+function invalidSelectorMessage(selector, reason) {
+  return `Invalid native selector ${JSON.stringify(selector)}: ${reason}.`;
+}
+function parseNativeSelector(selector) {
+  const trimmed = selector.trim();
+  if (trimmed.length === 0) {
+    throw new Error(
+      invalidSelectorMessage(
+        selector,
+        "selector is empty; use id=, label=, text=, role=, :focus, or a bare text value"
+      )
+    );
+  }
+  if (trimmed === ":focus") {
+    return { kind: "focused" };
+  }
+  const idMatch = /^id=(.+)$/s.exec(trimmed);
+  if (idMatch) {
+    return { kind: "id", value: unquoteSelectorValue(idMatch[1]) };
+  }
+  const roleMatch = ROLE_SELECTOR_RE.exec(trimmed);
+  if (roleMatch) {
+    const name = roleMatch[2] !== void 0 ? unquoteSelectorValue(roleMatch[2]) : void 0;
+    return name !== void 0 && name.length > 0 ? { kind: "role", role: roleMatch[1], name } : { kind: "role", role: roleMatch[1] };
+  }
+  const labelMatch = /^label=(.+)$/s.exec(trimmed);
+  if (labelMatch) {
+    return { kind: "label", value: unquoteSelectorValue(labelMatch[1]) };
+  }
+  const textMatch = /^text=(.+)$/s.exec(trimmed);
+  if (textMatch) {
+    return { kind: "text", value: unquoteSelectorValue(textMatch[1]) };
+  }
+  const prefix = NATIVE_SELECTOR_PREFIX_RE.exec(trimmed);
+  if (prefix) {
+    throw new Error(
+      invalidSelectorMessage(
+        selector,
+        `malformed ${prefix[1]}= selector; expected id=<value>, label=<value>, text=<value>, or role=<Type>[name=<value>]`
+      )
+    );
+  }
+  return { kind: "text", value: trimmed };
+}
+function unwrapNativeTextSelector(selector) {
+  const trimmed = selector.trim();
+  if (!trimmed.startsWith("text=")) {
+    return null;
+  }
+  return unquoteSelectorValue(trimmed.slice("text=".length));
+}
+function qualifyResourceId(value, appPackage) {
+  if (value.includes(":") || !appPackage) {
+    return value;
+  }
+  return `${appPackage}:id/${value}`;
+}
+function normalizeXcuiClassName(role) {
+  return role.startsWith("XCUIElementType") ? role : `XCUIElementType${role}`;
+}
+function shortIosType(type) {
+  return type.startsWith("XCUIElementType") ? type.slice("XCUIElementType".length) : type;
+}
+function rankNativeSelectors(fields) {
+  const selectors = [];
+  if (fields.id) {
+    selectors.push(`id=${fields.id}`);
+  }
+  if (fields.label) {
+    selectors.push(`label=${quoteSelectorValue(fields.label)}`);
+  }
+  if (fields.role && fields.name) {
+    selectors.push(`role=${fields.role}[name=${quoteSelectorValue(fields.name)}]`);
+  }
+  if (fields.name) {
+    selectors.push(`text=${quoteSelectorValue(fields.name)}`);
+  }
+  if (selectors.length === 0 && fields.role) {
+    selectors.push(`role=${fields.role}`);
+  }
+  return selectors;
+}
+
+// src/browser/android-driver.ts
 var ANDROID_CAPABILITIES = /* @__PURE__ */ new Set([
   "query",
   "interact",
@@ -2020,50 +2236,29 @@ var ANDROID_KEYCODES = {
   pageup: 92,
   pagedown: 93
 };
-function unquote2(value) {
-  const trimmed = value.trim();
-  const first = trimmed[0];
-  if ((first === '"' || first === "'") && trimmed.endsWith(first) && trimmed.length >= 2) {
-    return trimmed.slice(1, -1);
-  }
-  return trimmed;
-}
 function escapeUiSelectorArg(value) {
   return value.replace(/\\/g, "\\\\").replace(/"/g, '\\"');
 }
-function parseAndroidSelector(selector) {
-  const trimmed = selector.trim();
-  if (trimmed === ":focus") {
-    return { by: "focused" };
-  }
-  const idMatch = /^id=(.+)$/s.exec(trimmed);
-  if (idMatch) {
-    return { by: "id", value: unquote2(idMatch[1]) };
-  }
-  const roleMatch = /^role=([A-Za-z][\w.$-]*)(?:\[name=(.+)\])?$/s.exec(trimmed);
-  if (roleMatch) {
-    const name = roleMatch[2] !== void 0 ? unquote2(roleMatch[2]) : void 0;
-    return name !== void 0 && name.length > 0 ? { by: "role", role: roleMatch[1], name } : { by: "role", role: roleMatch[1] };
-  }
-  const labelMatch = /^label=(.+)$/s.exec(trimmed);
-  if (labelMatch) {
-    return { by: "accessibilityId", value: unquote2(labelMatch[1]) };
-  }
-  const textMatch = /^text=(.+)$/s.exec(trimmed);
-  if (textMatch) {
-    return { by: "text", value: unquote2(textMatch[1]) };
+function toAndroidQuery(selector) {
+  switch (selector.kind) {
+    case "focused":
+      return { by: "focused" };
+    case "id":
+      return { by: "id", value: selector.value };
+    case "role":
+      return selector.name !== void 0 ? { by: "role", role: selector.role, name: selector.name } : { by: "role", role: selector.role };
+    case "label":
+      return { by: "accessibilityId", value: selector.value };
+    case "text":
+      return { by: "text", value: selector.value };
   }
-  return { by: "text", value: trimmed };
+}
+function parseAndroidSelector(selector) {
+  return toAndroidQuery(parseNativeSelector(selector));
 }
 function locator(strategy, selector) {
   return { strategy, selector, context: "" };
 }
-function qualifyResourceId(value, appPackage) {
-  if (value.includes(":") || !appPackage) {
-    return value;
-  }
-  return `${appPackage}:id/${value}`;
-}
 function androidQueryToLocator(query, options = {}) {
   switch (query.by) {
     case "id":
@@ -2090,11 +2285,7 @@ function androidQueryToLocator(query, options = {}) {
   }
 }
 function unwrapAndroidTextSelector(selector) {
-  const trimmed = selector.trim();
-  if (!trimmed.startsWith("text=")) {
-    return null;
-  }
-  return unquote2(trimmed.slice(5));
+  return unwrapNativeTextSelector(selector);
 }
 function keyCodeFor(key) {
   const code = ANDROID_KEYCODES[key.trim().toLowerCase()];
@@ -2369,22 +2560,63 @@ async function installApk(runner, serial, apkPath) {
     );
   }
 }
+function formatUnknownError(error) {
+  return error instanceof Error ? error.message : String(error);
+}
+function runnerPhaseError(message, error) {
+  return new Error(`${message}: ${formatUnknownError(error)}`, { cause: error });
+}
+function parseResolvedComponent(stdout, pkg) {
+  const lines = stdout.split(/\r?\n/).map((l) => l.trim()).filter(Boolean);
+  for (let i = lines.length - 1; i >= 0; i--) {
+    if (/^[\w.]+\/[\w.$]+$/.test(lines[i]) && lines[i].startsWith(`${pkg}/`)) {
+      return lines[i];
+    }
+  }
+  return null;
+}
 async function launchPackage(runner, serial, pkg) {
-  const result = await runner(
-    withSerial(serial, [
-      "shell",
-      "monkey",
-      "-p",
-      pkg,
-      "-c",
-      "android.intent.category.LAUNCHER",
-      "1"
-    ]),
-    { timeoutMs: 3e4 }
-  );
-  if (result.code !== 0 || /no activities found|aborted|cannot launch/i.test(result.stdout + result.stderr)) {
+  let resolved;
+  try {
+    resolved = await runner(
+      withSerial(serial, [
+        "shell",
+        "cmd",
+        "package",
+        "resolve-activity",
+        "--brief",
+        "-c",
+        "android.intent.category.LAUNCHER",
+        pkg
+      ]),
+      { timeoutMs: 3e4 }
+    );
+  } catch (error) {
+    throw runnerPhaseError(
+      `Failed to resolve the launcher activity for Android package "${pkg}" via adb`,
+      error
+    );
+  }
+  const component = parseResolvedComponent(resolved.stdout, pkg);
+  if (resolved.code !== 0 || !component) {
+    throw new Error(
+      `Could not resolve a launcher activity for Android package "${pkg}" (exit ${resolved.code})${(resolved.stdout + resolved.stderr).trim() ? `: ${(resolved.stdout + resolved.stderr).trim().slice(0, 300)}` : ""}. Is it installed?`
+    );
+  }
+  let start;
+  try {
+    start = await runner(withSerial(serial, ["shell", "am", "start", "-n", component]), {
+      timeoutMs: 3e4
+    });
+  } catch (error) {
+    throw runnerPhaseError(
+      `Failed to launch Android package "${pkg}" with \`am start\` (${component}) via adb`,
+      error
+    );
+  }
+  if (start.code !== 0 || /error|does not exist|cannot start/i.test(start.stdout + start.stderr)) {
     throw new Error(
-      `Failed to launch Android package "${pkg}" (exit ${result.code}): ${(result.stdout + result.stderr).trim().slice(0, 400)}. Is it installed?`
+      `Failed to launch Android package "${pkg}" (${component}, exit ${start.code}): ${(start.stdout + start.stderr).trim().slice(0, 400)}.`
     );
   }
 }
@@ -2602,6 +2834,13 @@ function createUia2AgentClient(transport, sessionId, options = {}) {
       }
       return Buffer.from(value, "base64");
     },
+    async source() {
+      const value = await transport.request("GET", `${base}/source`);
+      if (typeof value !== "string") {
+        throw new Error("uiautomator2 /source did not return XML text; cannot analyze Android UI hierarchy");
+      }
+      return value;
+    },
     async close() {
       await transport.request("DELETE", base).catch(() => void 0);
     }
@@ -2745,6 +2984,7 @@ async function closeAndroidSession(session) {
 
 // src/browser/ios-helper.ts
 var import_node_module2 = require("module");
+var import_node_child_process6 = require("child_process");
 var import_node_fs7 = __toESM(require("fs"), 1);
 var import_node_os2 = __toESM(require("os"), 1);
 var import_node_path7 = __toESM(require("path"), 1);
@@ -2759,43 +2999,25 @@ var IOS_CAPABILITIES = /* @__PURE__ */ new Set([
 var WAIT_POLL_INTERVAL_MS2 = 250;
 var DEFAULT_WAIT_TIMEOUT_MS2 = 5e3;
 var IOS_PRESS_KEYS = ["backspace", "del", "delete", "enter", "home", "return"];
-function unquote3(value) {
-  const trimmed = value.trim();
-  const first = trimmed[0];
-  if ((first === '"' || first === "'") && trimmed.endsWith(first) && trimmed.length >= 2) {
-    return trimmed.slice(1, -1);
-  }
-  return trimmed;
-}
 function escapePredicateArg(value) {
   return value.replace(/\\/g, "\\\\").replace(/"/g, '\\"');
 }
-function normalizeXcuiClassName(role) {
-  return role.startsWith("XCUIElementType") ? role : `XCUIElementType${role}`;
+function toIosQuery(selector) {
+  switch (selector.kind) {
+    case "focused":
+      return { by: "focused" };
+    case "id":
+      return { by: "accessibilityId", value: selector.value };
+    case "role":
+      return selector.name !== void 0 ? { by: "role", role: selector.role, name: selector.name } : { by: "role", role: selector.role };
+    case "label":
+      return { by: "label", value: selector.value };
+    case "text":
+      return { by: "text", value: selector.value };
+  }
 }
 function parseIosSelector(selector) {
-  const trimmed = selector.trim();
-  if (trimmed === ":focus") {
-    return { by: "focused" };
-  }
-  const idMatch = /^id=(.+)$/s.exec(trimmed);
-  if (idMatch) {
-    return { by: "accessibilityId", value: unquote3(idMatch[1]) };
-  }
-  const roleMatch = /^role=([A-Za-z][\w.$-]*)(?:\[name=(.+)\])?$/s.exec(trimmed);
-  if (roleMatch) {
-    const name = roleMatch[2] !== void 0 ? unquote3(roleMatch[2]) : void 0;
-    return name !== void 0 && name.length > 0 ? { by: "role", role: roleMatch[1], name } : { by: "role", role: roleMatch[1] };
-  }
-  const labelMatch = /^label=(.+)$/s.exec(trimmed);
-  if (labelMatch) {
-    return { by: "label", value: unquote3(labelMatch[1]) };
-  }
-  const textMatch = /^text=(.+)$/s.exec(trimmed);
-  if (textMatch) {
-    return { by: "text", value: unquote3(textMatch[1]) };
-  }
-  return { by: "text", value: trimmed };
+  return toIosQuery(parseNativeSelector(selector));
 }
 function iosQueryToLocator(query) {
   switch (query.by) {
@@ -2827,11 +3049,7 @@ function iosQueryToLocator(query) {
   }
 }
 function unwrapIosTextSelector(selector) {
-  const trimmed = selector.trim();
-  if (!trimmed.startsWith("text=")) {
-    return null;
-  }
-  return unquote3(trimmed.slice(5));
+  return unwrapNativeTextSelector(selector);
 }
 function delay2(ms) {
   return new Promise((resolve) => {
@@ -2995,6 +3213,19 @@ var import_promises = require("fs/promises");
 var import_node_net = __toESM(require("net"), 1);
 var import_node_os = __toESM(require("os"), 1);
 var import_node_path6 = __toESM(require("path"), 1);
+var spawnXcrunProcess = (args, options) => {
+  const child = (0, import_node_child_process5.spawn)("xcrun", args, {
+    stdio: "ignore",
+    env: options?.env ? { ...process.env, ...options.env } : process.env
+  });
+  child.on("error", () => {
+  });
+  return {
+    kill: () => {
+      child.kill();
+    }
+  };
+};
 var DEFAULT_SIMULATOR_LOCK_ROOT = import_node_path6.default.join(import_node_os.default.tmpdir(), "prowl-ios-simulator-locks");
 var SIMULATOR_LOCK_OWNER_FILE = "owner.json";
 var execFileXcrunRunner = (args, options) => new Promise((resolve) => {
@@ -3431,6 +3662,13 @@ function createWdaAgentClient(transport, sessionId) {
     async homescreen() {
       await transport.request("POST", "/wda/homescreen", {});
     },
+    async source() {
+      const value = await transport.request("GET", "/source");
+      if (typeof value !== "string") {
+        throw new Error("WebDriverAgent /source did not return XML text; cannot analyze iOS UI hierarchy");
+      }
+      return value;
+    },
     async close() {
       await transport.request("DELETE", base).catch(() => void 0);
     }
@@ -3440,8 +3678,8 @@ function createWdaAgentClient(transport, sessionId) {
 // src/browser/ios-helper.ts
 var import_meta3 = {};
 var WDA_RUNNER_BUNDLE_ID = "com.facebook.WebDriverAgentRunner.xctrunner";
-var WDA_RUNNER_APP_NAME = "WebDriverAgentRunner-Runner.app";
 var WDA_USE_PORT_ENV = "USE_PORT";
+var PREPARED_XCTESTRUN_PREFIX = "prowl-wda-xctestrun-";
 var WDA_STARTUP_ATTEMPTS = 2;
 var defaultIosAgentConnector = async ({
   host,
@@ -3475,10 +3713,44 @@ function resolveWdaProject(requireFn = (0, import_node_module2.createRequire)(im
 function wdaCacheDir(wdaVersion, xcode, homeDir = import_node_os2.default.homedir()) {
   return import_node_path7.default.join(homeDir, ".prowl", "wda", `${wdaVersion}-xcode${xcode}`);
 }
-function runnerAppPath(derivedDataPath) {
-  return import_node_path7.default.join(derivedDataPath, "Build", "Products", "Debug-iphonesimulator", WDA_RUNNER_APP_NAME);
+function productsDir(derivedDataPath) {
+  return import_node_path7.default.join(derivedDataPath, "Build", "Products");
 }
-async function resolveWdaRunner(options = {}) {
+function findXctestrunIn(dir) {
+  let entries;
+  try {
+    entries = import_node_fs7.default.readdirSync(dir);
+  } catch {
+    return null;
+  }
+  const match = entries.filter((name) => name.endsWith(".xctestrun") && !name.startsWith(PREPARED_XCTESTRUN_PREFIX)).sort()[0];
+  return match ? import_node_path7.default.join(dir, match) : null;
+}
+function resolveOverrideXctestrun(override) {
+  if (!import_node_fs7.default.existsSync(override)) {
+    throw new Error(`PROWL_WDA_RUNNER points at a missing path: ${override}`);
+  }
+  if (override.endsWith(".xctestrun")) {
+    return override;
+  }
+  const candidates = [];
+  const stat = import_node_fs7.default.statSync(override);
+  if (override.endsWith(".app")) {
+    candidates.push(import_node_path7.default.dirname(import_node_path7.default.dirname(override)));
+  } else if (stat.isDirectory()) {
+    candidates.push(override, productsDir(override));
+  }
+  for (const dir of candidates) {
+    const found = findXctestrunIn(dir);
+    if (found) {
+      return found;
+    }
+  }
+  throw new Error(
+    `PROWL_WDA_RUNNER (${override}) does not resolve to a WebDriverAgent .xctestrun. Point it at the generated \`*.xctestrun\`, at the \`-derivedDataPath\` directory from \`xcodebuild build-for-testing\`, or at that build's runner \`.app\`.`
+  );
+}
+async function resolveWdaTestRun(options = {}) {
   const runner = options.runner ?? execFileXcrunRunner;
   const env = options.env ?? process.env;
   const homeDir = options.homeDir ?? import_node_os2.default.homedir();
@@ -3486,10 +3758,7 @@ async function resolveWdaRunner(options = {}) {
 `));
   const override = env.PROWL_WDA_RUNNER;
   if (override) {
-    if (!import_node_fs7.default.existsSync(override)) {
-      throw new Error(`PROWL_WDA_RUNNER points at a missing path: ${override}`);
-    }
-    return override;
+    return resolveOverrideXctestrun(override);
   }
   const { projectPath, version } = resolveWdaProject(options.requireFn);
   const xcode = await xcodeVersion(runner);
@@ -3499,9 +3768,9 @@ async function resolveWdaRunner(options = {}) {
     );
   }
   const cacheDir = wdaCacheDir(version, xcode, homeDir);
-  const cachedRunner = runnerAppPath(cacheDir);
-  if (import_node_fs7.default.existsSync(cachedRunner)) {
-    return cachedRunner;
+  const cached = findXctestrunIn(productsDir(cacheDir));
+  if (cached) {
+    return cached;
   }
   log(
     `Prowl: building WebDriverAgent for the iOS target (first run only; this can take a few minutes)\u2026`
@@ -3528,12 +3797,106 @@ async function resolveWdaRunner(options = {}) {
       `Failed to build WebDriverAgent with \`xcodebuild build-for-testing\`. Ensure a full Xcode (not just the command-line tools) is installed and selected (\`xcode-select -p\`). Details: ${(result.stderr.trim() || result.stdout.trim()).slice(-800)}`
     );
   }
-  if (!import_node_fs7.default.existsSync(cachedRunner)) {
+  const built = findXctestrunIn(productsDir(cacheDir));
+  if (!built) {
     throw new Error(
-      `WebDriverAgent build succeeded but the runner app was not found at ${cachedRunner}. This may indicate an Xcode layout change; set PROWL_WDA_RUNNER to a prebuilt runner.`
+      `WebDriverAgent build succeeded but no .xctestrun was found under ${productsDir(cacheDir)}. This may indicate an Xcode layout change; set PROWL_WDA_RUNNER to a prebuilt runner/xctestrun.`
     );
   }
-  return cachedRunner;
+  return built;
+}
+function injectUsePortIntoXctestrun(plist, port) {
+  const clone = structuredClone(plist);
+  let injected = 0;
+  const visit = (node) => {
+    if (Array.isArray(node)) {
+      for (const entry of node) {
+        visit(entry);
+      }
+      return;
+    }
+    if (!node || typeof node !== "object") {
+      return;
+    }
+    const obj = node;
+    const isTarget = typeof obj.TestBundlePath === "string" || typeof obj.TestHostPath === "string";
+    const existingEnv = obj.EnvironmentVariables && typeof obj.EnvironmentVariables === "object" && !Array.isArray(obj.EnvironmentVariables) ? obj.EnvironmentVariables : void 0;
+    if (isTarget || existingEnv) {
+      const env = existingEnv ?? {};
+      env[WDA_USE_PORT_ENV] = String(port);
+      obj.EnvironmentVariables = env;
+      injected += 1;
+    }
+    for (const value of Object.values(obj)) {
+      visit(value);
+    }
+  };
+  visit(clone);
+  if (injected === 0) {
+    throw new Error(
+      "Could not find a test target in the WebDriverAgent .xctestrun to set USE_PORT. The xctestrun format may have changed; set PROWL_WDA_RUNNER to a compatible runner."
+    );
+  }
+  return clone;
+}
+function runPlutil(args) {
+  return new Promise((resolve, reject) => {
+    (0, import_node_child_process6.execFile)(
+      "plutil",
+      args,
+      { encoding: "utf-8", maxBuffer: 32 * 1024 * 1024 },
+      (error, stdout, stderr) => {
+        if (error) {
+          reject(
+            new Error(
+              `\`plutil ${args.join(" ")}\` failed: ${(stderr || error.message).slice(0, 400)}`
+            )
+          );
+          return;
+        }
+        resolve(stdout ?? "");
+      }
+    );
+  });
+}
+var defaultWdaTestRunPreparer = async ({ xctestrunPath, port }) => {
+  const json = await runPlutil(["-convert", "json", "-o", "-", xctestrunPath]);
+  let parsed;
+  try {
+    parsed = JSON.parse(json);
+  } catch {
+    throw new Error(`Could not parse the WebDriverAgent .xctestrun as JSON: ${xctestrunPath}`);
+  }
+  const injected = injectUsePortIntoXctestrun(parsed, port);
+  const stem = `${PREPARED_XCTESTRUN_PREFIX}${port}-${process.pid}`;
+  const outPath = import_node_path7.default.join(import_node_path7.default.dirname(xctestrunPath), `${stem}.xctestrun`);
+  const jsonPath = import_node_path7.default.join(import_node_os2.default.tmpdir(), `${stem}.json`);
+  import_node_fs7.default.writeFileSync(jsonPath, JSON.stringify(injected));
+  try {
+    await runPlutil(["-convert", "xml1", jsonPath, "-o", outPath]);
+  } finally {
+    import_node_fs7.default.rmSync(jsonPath, { force: true });
+  }
+  return outPath;
+};
+function cleanupPreparedTestRun(preparedPath) {
+  if (!preparedPath) {
+    return;
+  }
+  if (!import_node_path7.default.basename(preparedPath).startsWith(PREPARED_XCTESTRUN_PREFIX)) {
+    return;
+  }
+  import_node_fs7.default.rmSync(preparedPath, { force: true });
+}
+function wdaTestRunArgs(xctestrunPath, udid) {
+  return [
+    "xcodebuild",
+    "test-without-building",
+    "-xctestrun",
+    xctestrunPath,
+    "-destination",
+    `id=${udid}`
+  ];
 }
 async function resolveBundleId(app, runner, udid, coldStart, allowedApps) {
   if (!looksLikeIosAppPath(app)) {
@@ -3564,6 +3927,8 @@ async function resolveBundleId(app, runner, udid, coldStart, allowedApps) {
 }
 async function launchIosSession(options) {
   const runner = options.runner ?? execFileXcrunRunner;
+  const spawner = options.spawner ?? spawnXcrunProcess;
+  const preparer = options.testRunPreparer ?? defaultWdaTestRunPreparer;
   const portAllocator = options.portAllocator ?? findFreePort;
   const connector = options.agentConnector ?? defaultIosAgentConnector;
   const requestTimeoutMs = Math.max(options.timeoutMs ?? 1e4, DEFAULT_WDA_REQUEST_TIMEOUT_MS) + 5e3;
@@ -3587,14 +3952,14 @@ async function launchIosSession(options) {
       options.coldStart ?? false,
       options.allowedApps ?? []
     );
-    const wdaRunnerApp = options.wdaRunnerApp ?? await resolveWdaRunner({ runner, logger: options.logger });
-    await installApp(runner, udid, wdaRunnerApp);
+    const baseTestRun = options.wdaTestRun ?? await resolveWdaTestRun({ runner, logger: options.logger });
     for (let attempt = 1; attempt <= WDA_STARTUP_ATTEMPTS; attempt += 1) {
       let client;
+      let wdaProcess;
+      let preparedTestRun;
       let tornDown = false;
-      let terminateWda = false;
       let terminateTarget = false;
-      let stage = "port";
+      let stage = "prepare";
       const teardownAttempt = async () => {
         if (tornDown) {
           return;
@@ -3603,18 +3968,18 @@ async function launchIosSession(options) {
         if (client) {
           await client.close().catch(() => void 0);
         }
-        if (terminateWda) {
-          await terminateApp(runner, udid, WDA_RUNNER_BUNDLE_ID);
-        }
+        wdaProcess?.kill();
+        await terminateApp(runner, udid, WDA_RUNNER_BUNDLE_ID);
         if (terminateTarget) {
           await terminateApp(runner, udid, bundleId);
         }
+        cleanupPreparedTestRun(preparedTestRun);
       };
       try {
         const port = await portAllocator();
+        preparedTestRun = await preparer({ xctestrunPath: baseTestRun, port });
         stage = "wda-launch";
-        terminateWda = true;
-        await launchApp(runner, udid, WDA_RUNNER_BUNDLE_ID, { [WDA_USE_PORT_ENV]: String(port) });
+        wdaProcess = spawner(wdaTestRunArgs(preparedTestRun, udid));
         stage = "target-launch";
         terminateTarget = true;
         await launchApp(runner, udid, bundleId);
@@ -3793,14 +4158,254 @@ function createRunPolicy(driver, options) {
     return { selector: healed.selector, healedFrom: healed.healedFrom };
   }
   return {
-    assertWithinMaxSteps,
-    ensureUrlAllowed,
-    ensureAppAllowed,
-    ensureLocationAllowed,
-    assertAllowedSelector,
-    resolveActionSelector
+    assertWithinMaxSteps,
+    ensureUrlAllowed,
+    ensureAppAllowed,
+    ensureLocationAllowed,
+    assertAllowedSelector,
+    resolveActionSelector
+  };
+}
+
+// src/generator/ai.ts
+var DEFAULT_BASE_URL = {
+  anthropic: "https://api.anthropic.com",
+  openai: "https://api.openai.com"
+};
+var AI_REQUEST_TIMEOUT_MS = 3e4;
+function apiRoot(config) {
+  return config.baseUrl ?? DEFAULT_BASE_URL[config.provider];
+}
+function defaultModelFor(provider) {
+  return provider === "anthropic" ? "claude-sonnet-4-5-20250929" : "gpt-4o";
+}
+function resolveAiEnv() {
+  const provider = process.env.PROWL_AI_PROVIDER ?? "anthropic";
+  if (provider !== "anthropic" && provider !== "openai") {
+    throw new Error(`Unsupported AI provider: ${provider}. Use "anthropic" or "openai".`);
+  }
+  const model = process.env.PROWL_AI_MODEL ?? defaultModelFor(provider);
+  const baseUrl = normalizeBaseUrl(process.env.PROWL_AI_BASE_URL) ?? DEFAULT_BASE_URL[provider];
+  return { provider, model, baseUrl, apiKey: process.env.PROWL_AI_KEY };
+}
+function normalizeBaseUrl(value) {
+  if (value === void 0) return void 0;
+  const trimmed = value.trim().replace(/\/+$/, "");
+  return trimmed.length > 0 ? trimmed : void 0;
+}
+function resolveAiConfig() {
+  const env = resolveAiEnv();
+  if (!env.apiKey) {
+    throw new Error(
+      "PROWL_AI_KEY environment variable is required. Set it to your Anthropic or OpenAI API key."
+    );
+  }
+  return { provider: env.provider, model: env.model, apiKey: env.apiKey, baseUrl: env.baseUrl };
+}
+function tryResolveAiConfig() {
+  const env = resolveAiEnv();
+  if (!env.apiKey) {
+    return null;
+  }
+  return { provider: env.provider, model: env.model, apiKey: env.apiKey, baseUrl: env.baseUrl };
+}
+async function generateWithAi(prompt, config) {
+  if (config.provider === "anthropic") {
+    return generateWithAnthropic(prompt, config);
+  }
+  return generateWithOpenAi(prompt, config);
+}
+async function generateWithAnthropic(prompt, config) {
+  const data = await postJson(
+    "Anthropic",
+    `${apiRoot(config)}/v1/messages`,
+    anthropicHeaders(config),
+    {
+      model: config.model,
+      max_tokens: 4096,
+      messages: [
+        { role: "user", content: prompt }
+      ]
+    }
+  );
+  return extractAnthropicText(data);
+}
+async function generateWithOpenAi(prompt, config) {
+  const data = await postJson(
+    "OpenAI",
+    `${apiRoot(config)}/v1/chat/completions`,
+    openAiHeaders(config),
+    {
+      model: config.model,
+      messages: [
+        { role: "user", content: prompt }
+      ],
+      max_tokens: 4096
+    }
+  );
+  return extractOpenAiText(data);
+}
+function buildVisionPrompt(assertion) {
+  return [
+    "You are a meticulous QA reviewer. You are given a screenshot of an application",
+    "and a single assertion describing what should be true about it.",
+    "",
+    "Assertion:",
+    assertion,
+    "",
+    "Decide whether the assertion holds for the screenshot. Judge ONLY what is",
+    "visible; do not assume behavior you cannot see. Be strict: if the assertion",
+    "is not clearly satisfied, it fails.",
+    "",
+    "Reply with ONLY a single JSON object on one line, no markdown, no code fences:",
+    '{"pass": <true|false>, "reason": "<one concise sentence explaining the verdict>"}'
+  ].join("\n");
+}
+function parseVisionVerdict(raw) {
+  const cleaned = stripCodeFences(raw).trim();
+  const candidate = extractJsonObject(cleaned);
+  if (candidate === null) {
+    throw new Error(
+      `Could not parse a JSON verdict from the AI response: ${truncateForError(raw)}`
+    );
+  }
+  let parsed;
+  try {
+    parsed = JSON.parse(candidate);
+  } catch {
+    throw new Error(
+      `AI verdict was not valid JSON: ${truncateForError(raw)}`
+    );
+  }
+  if (typeof parsed !== "object" || parsed === null) {
+    throw new Error(`AI verdict was not a JSON object: ${truncateForError(raw)}`);
+  }
+  const record = parsed;
+  if (typeof record.pass !== "boolean") {
+    throw new Error(
+      `AI verdict is missing a boolean "pass" field: ${truncateForError(raw)}`
+    );
+  }
+  const reason = typeof record.reason === "string" && record.reason.trim().length > 0 ? record.reason.trim() : record.pass ? "Assertion satisfied." : "Assertion not satisfied.";
+  return { pass: record.pass, reason };
+}
+function stripCodeFences(text) {
+  const fence = text.match(/```(?:json)?\s*([\s\S]*?)```/i);
+  return fence ? fence[1] : text;
+}
+function extractJsonObject(text) {
+  const trimmed = text.trim();
+  if (trimmed.startsWith("{") && trimmed.endsWith("}")) {
+    return trimmed;
+  }
+  const first = trimmed.indexOf("{");
+  const last = trimmed.lastIndexOf("}");
+  if (first === -1 || last === -1 || last <= first) {
+    return null;
+  }
+  return trimmed.slice(first, last + 1);
+}
+function truncateForError(text) {
+  const collapsed = text.replace(/\s+/g, " ").trim();
+  return collapsed.length > 200 ? `${collapsed.slice(0, 199)}\u2026` : collapsed;
+}
+async function assertWithAiVision(input, config) {
+  const raw = config.provider === "anthropic" ? await visionWithAnthropic(input, config) : await visionWithOpenAi(input, config);
+  return parseVisionVerdict(raw);
+}
+async function visionWithAnthropic(input, config) {
+  const data = await postJson(
+    "Anthropic",
+    `${apiRoot(config)}/v1/messages`,
+    anthropicHeaders(config),
+    {
+      model: config.model,
+      max_tokens: 1024,
+      temperature: 0,
+      messages: [
+        {
+          role: "user",
+          content: [
+            {
+              type: "image",
+              source: {
+                type: "base64",
+                media_type: input.mediaType,
+                data: input.imageBase64
+              }
+            },
+            { type: "text", text: buildVisionPrompt(input.assertion) }
+          ]
+        }
+      ]
+    }
+  );
+  return extractAnthropicText(data);
+}
+async function visionWithOpenAi(input, config) {
+  const data = await postJson(
+    "OpenAI",
+    `${apiRoot(config)}/v1/chat/completions`,
+    openAiHeaders(config),
+    {
+      model: config.model,
+      max_tokens: 1024,
+      temperature: 0,
+      messages: [
+        {
+          role: "user",
+          content: [
+            { type: "text", text: buildVisionPrompt(input.assertion) },
+            {
+              type: "image_url",
+              image_url: { url: `data:${input.mediaType};base64,${input.imageBase64}` }
+            }
+          ]
+        }
+      ]
+    }
+  );
+  return extractOpenAiText(data);
+}
+async function postJson(provider, url, headers, body) {
+  const response = await fetch(url, {
+    method: "POST",
+    headers,
+    body: JSON.stringify(body),
+    signal: AbortSignal.timeout(AI_REQUEST_TIMEOUT_MS)
+  });
+  if (!response.ok) {
+    const responseBody = await response.text();
+    throw new Error(`${provider} API error (${response.status}): ${responseBody}`);
+  }
+  return await response.json();
+}
+function anthropicHeaders(config) {
+  return {
+    "Content-Type": "application/json",
+    "x-api-key": config.apiKey,
+    "anthropic-version": "2023-06-01"
+  };
+}
+function openAiHeaders(config) {
+  return {
+    "Content-Type": "application/json",
+    "Authorization": `Bearer ${config.apiKey}`
   };
 }
+function extractAnthropicText(data) {
+  const textBlock = data.content?.find((c) => c.type === "text");
+  if (!textBlock?.text) {
+    throw new Error("Anthropic API returned no text content");
+  }
+  return textBlock.text;
+}
+function extractOpenAiText(data) {
+  if (!data.choices?.[0]?.message?.content) {
+    throw new Error("OpenAI API returned no content");
+  }
+  return data.choices[0].message.content;
+}
 
 // src/runner/steps.ts
 function getStepType(step) {
@@ -3830,6 +4435,7 @@ function getStepType(step) {
   if ("evalScript" in step) return "evalScript";
   if ("runScript" in step) return "runScript";
   if ("assertScreenshot" in step) return "assertScreenshot";
+  if ("assertWithAI" in step) return "assertWithAI";
   if ("copyText" in step) return "copyText";
   if ("waitForDownload" in step) return "waitForDownload";
   return "step";
@@ -3889,6 +4495,9 @@ function applyRuntimeVars(step, vars) {
       }
     };
   }
+  if ("assertWithAI" in step) {
+    return { assertWithAI: sub(step.assertWithAI) };
+  }
   if ("copyText" in step) {
     return { copyText: { selector: sub(step.copyText.selector), as: step.copyText.as } };
   }
@@ -4822,6 +5431,48 @@ var STEP_HANDLERS = {
       );
     }
   },
+  assertWithAI: {
+    capabilities: ["screenshot"],
+    run: async (h) => {
+      if (!("assertWithAI" in h.step)) unknownStep();
+      const assertion = h.step.assertWithAI;
+      const resolve = h.context.resolveAiConfig ?? tryResolveAiConfig;
+      const aiConfig = resolve();
+      if (!aiConfig) {
+        return {
+          kind: "result",
+          result: {
+            type: "assertWithAI",
+            status: "warn",
+            durationMs: Date.now() - h.stepStart,
+            value: `skipped: no AI provider configured (set PROWL_AI_KEY to enable) \u2014 "${assertion}"`
+          }
+        };
+      }
+      const fileName = `assertWithAI_step_${h.index + 1}.png`;
+      const relative = await h.addScreenshot(fileName);
+      const screenshotFullPath = import_node_path9.default.join(h.context.runDir, relative);
+      const imageBase64 = import_node_fs9.default.readFileSync(screenshotFullPath).toString("base64");
+      const assertVision = h.context.assertVision ?? assertWithAiVision;
+      const verdict = await assertVision(
+        { imageBase64, mediaType: "image/png", assertion },
+        aiConfig
+      );
+      if (verdict.pass) {
+        return {
+          kind: "result",
+          result: {
+            type: "assertWithAI",
+            status: "pass",
+            durationMs: Date.now() - h.stepStart,
+            value: verdict.reason,
+            screenshot: relative
+          }
+        };
+      }
+      throw new Error(`AI assertion failed: ${verdict.reason}`);
+    }
+  },
   copyText: {
     capabilities: ["query"],
     run: async (h) => {
@@ -5964,6 +6615,7 @@ function describeStep(step) {
     const th = step.assertScreenshot.threshold !== void 0 ? ` (threshold: ${step.assertScreenshot.threshold})` : "";
     return `assertScreenshot "${step.assertScreenshot.name}"${th}`;
   }
+  if ("assertWithAI" in step) return `assertWithAI "${truncate(step.assertWithAI, 60)}"`;
   return "unknown step";
 }
 function truncate(text, max) {
@@ -5979,6 +6631,9 @@ function printStepResult(result, step, _index) {
   const duration = import_chalk.default.gray(`(${result.durationMs}ms)`);
   if (result.status === "pass") {
     console.log(`    ${import_chalk.default.green("\u2713")} ${label} ${duration}`);
+  } else if (result.status === "warn") {
+    const note = result.value ? import_chalk.default.gray(` \u2014 ${result.value}`) : "";
+    console.log(`    ${import_chalk.default.yellow("\u25CB")} ${label} ${duration}${note}`);
   } else {
     const error = result.error ? import_chalk.default.gray(` \u2014 ${result.error}`) : "";
     console.log(`    ${import_chalk.default.red("\u2717")} ${label} ${duration}${error}`);
@@ -7370,6 +8025,220 @@ async function readStatusMenu(client, menuTimeoutSeconds) {
   }
 }
 
+// src/analyzer/android.ts
+var ANDROID_INTERACTIVE_CLASSES = /* @__PURE__ */ new Set([
+  "android.widget.Button",
+  "android.widget.ImageButton",
+  "android.widget.EditText",
+  "android.widget.CheckBox",
+  "android.widget.RadioButton",
+  "android.widget.Switch",
+  "android.widget.ToggleButton",
+  "android.widget.Spinner",
+  "android.widget.SeekBar",
+  "android.widget.RatingBar",
+  "android.widget.CompoundButton",
+  "android.widget.AutoCompleteTextView",
+  "android.widget.MultiAutoCompleteTextView",
+  "android.widget.CheckedTextView",
+  "androidx.appcompat.widget.SwitchCompat",
+  "androidx.appcompat.widget.AppCompatButton",
+  "androidx.appcompat.widget.AppCompatEditText"
+]);
+function str2(value) {
+  if (value === void 0) {
+    return void 0;
+  }
+  const trimmed = value.trim();
+  return trimmed.length > 0 ? trimmed : void 0;
+}
+function bool(value) {
+  if (value === void 0) {
+    return void 0;
+  }
+  return value === "true";
+}
+function toAndroidNode(element) {
+  const a = element.attrs;
+  return {
+    className: str2(a["class"]),
+    resourceId: str2(a["resource-id"]),
+    contentDesc: str2(a["content-desc"]),
+    text: str2(a.text),
+    package: str2(a.package),
+    clickable: bool(a.clickable),
+    longClickable: bool(a["long-clickable"]),
+    checkable: bool(a.checkable),
+    checked: bool(a.checked),
+    scrollable: bool(a.scrollable),
+    focusable: bool(a.focusable),
+    focused: bool(a.focused),
+    enabled: bool(a.enabled),
+    children: element.children.map(toAndroidNode)
+  };
+}
+function parseAndroidHierarchy(xml) {
+  const root = parseXml(xml);
+  return root ? toAndroidNode(root) : null;
+}
+function isAndroidInteractive(node) {
+  if (node.clickable || node.longClickable || node.checkable || node.scrollable) {
+    return true;
+  }
+  return node.className !== void 0 && ANDROID_INTERACTIVE_CLASSES.has(node.className);
+}
+function rankAndroidSelectors(node) {
+  return rankNativeSelectors({
+    id: node.resourceId,
+    label: node.contentDesc,
+    role: node.className,
+    name: node.text
+  });
+}
+function toElement2(node) {
+  return {
+    className: node.className ?? "?",
+    ...node.resourceId ? { resourceId: node.resourceId } : {},
+    ...node.contentDesc ? { contentDesc: node.contentDesc } : {},
+    ...node.text ? { text: node.text } : {},
+    ...node.clickable !== void 0 ? { clickable: node.clickable } : {},
+    ...node.checkable !== void 0 ? { checkable: node.checkable } : {},
+    ...node.scrollable !== void 0 ? { scrollable: node.scrollable } : {},
+    ...node.enabled !== void 0 ? { enabled: node.enabled } : {},
+    selectors: rankAndroidSelectors(node)
+  };
+}
+function collectInteractive2(root) {
+  const out = [];
+  const visit = (node) => {
+    if (isAndroidInteractive(node)) {
+      out.push(toElement2(node));
+    }
+    for (const child of node.children) {
+      visit(child);
+    }
+  };
+  visit(root);
+  return out;
+}
+async function analyzeAndroidApp(client, options) {
+  const xml = await client.source();
+  const root = parseAndroidHierarchy(xml);
+  const elements = root ? collectInteractive2(root) : [];
+  return { app: options.app, elements };
+}
+
+// src/analyzer/ios.ts
+var IOS_INTERACTIVE_TYPES = /* @__PURE__ */ new Set([
+  "XCUIElementTypeButton",
+  "XCUIElementTypeCell",
+  "XCUIElementTypeTextField",
+  "XCUIElementTypeSecureTextField",
+  "XCUIElementTypeSearchField",
+  "XCUIElementTypeSwitch",
+  "XCUIElementTypeToggle",
+  "XCUIElementTypeLink",
+  "XCUIElementTypeMenuItem",
+  "XCUIElementTypeSlider",
+  "XCUIElementTypeStepper",
+  "XCUIElementTypeTextView",
+  "XCUIElementTypePickerWheel",
+  "XCUIElementTypeTab",
+  "XCUIElementTypeSegmentedControl",
+  "XCUIElementTypeCheckBox",
+  "XCUIElementTypeRadioButton",
+  "XCUIElementTypeKey"
+]);
+var IOS_WINDOW_TYPE = "XCUIElementTypeWindow";
+function str3(value) {
+  if (value === void 0) {
+    return void 0;
+  }
+  const trimmed = value.trim();
+  return trimmed.length > 0 ? trimmed : void 0;
+}
+function bool2(value) {
+  if (value === void 0) {
+    return void 0;
+  }
+  return value === "true" || value === "1";
+}
+function toIosNode(element) {
+  const a = element.attrs;
+  return {
+    type: str3(a.type) ?? str3(element.tag),
+    name: str3(a.name),
+    label: str3(a.label),
+    value: str3(a.value),
+    enabled: bool2(a.enabled),
+    visible: bool2(a.visible),
+    children: element.children.map(toIosNode)
+  };
+}
+function parseIosHierarchy(xml) {
+  const root = parseXml(xml);
+  return root ? toIosNode(root) : null;
+}
+function hasAccessibilityId(node) {
+  return node.name !== void 0 && node.name !== node.label;
+}
+function rankIosSelectors(node) {
+  return rankNativeSelectors({
+    id: hasAccessibilityId(node) ? node.name : void 0,
+    label: node.label,
+    role: node.type ? shortIosType(node.type) : void 0,
+    name: node.label ?? node.value
+  });
+}
+function toElement3(node) {
+  return {
+    type: node.type ?? "?",
+    ...node.name ? { name: node.name } : {},
+    ...node.label ? { label: node.label } : {},
+    ...node.value ? { value: node.value } : {},
+    ...node.enabled !== void 0 ? { enabled: node.enabled } : {},
+    ...node.visible !== void 0 ? { visible: node.visible } : {},
+    selectors: rankIosSelectors(node)
+  };
+}
+function toWindow2(node) {
+  const [best] = rankIosSelectors(node);
+  return {
+    ...node.name ? { name: node.name } : {},
+    ...node.label ? { label: node.label } : {},
+    selector: best ?? `role=${shortIosType(IOS_WINDOW_TYPE)}`
+  };
+}
+function isIosInteractive(node) {
+  return node.type !== void 0 && IOS_INTERACTIVE_TYPES.has(node.type);
+}
+function collect(root) {
+  const elements = [];
+  const windows = [];
+  const visit = (node) => {
+    if (node.type === IOS_WINDOW_TYPE) {
+      windows.push(toWindow2(node));
+    }
+    if (isIosInteractive(node)) {
+      elements.push(toElement3(node));
+    }
+    for (const child of node.children) {
+      visit(child);
+    }
+  };
+  visit(root);
+  return { elements, windows };
+}
+async function analyzeIosApp(client, options) {
+  const xml = await client.source();
+  const root = parseIosHierarchy(xml);
+  if (!root) {
+    return { app: options.app, elements: [], windows: [] };
+  }
+  const { elements, windows } = collect(root);
+  return { app: options.app, elements, windows };
+}
+
 // src/cli/commands/analyze.ts
 init_loader();
 function parseViewportFlag2(value) {
@@ -7391,6 +8260,23 @@ function tryLoadConfig(configPath) {
     throw new Error(`Failed to load config at ${configLocation}: ${message}`);
   }
 }
+function looksLikeApk2(app) {
+  return /\.apk$/i.test(app.trim());
+}
+function pickNativePlatform(platformFlag, config, app) {
+  if (platformFlag !== void 0) {
+    const normalized = platformFlag.trim().toLowerCase();
+    if (normalized === "macos" || normalized === "android" || normalized === "ios") {
+      return normalized;
+    }
+    throw new Error(`Unknown --platform "${platformFlag}". Use one of: macos, android, ios.`);
+  }
+  const configType = config?.target.type;
+  if (configType === "macos" || configType === "android" || configType === "ios") {
+    return configType;
+  }
+  return looksLikeApk2(app) ? "android" : "macos";
+}
 async function runWebAnalyze(url, options) {
   const engine = parseBrowserEngine(options.browser);
   const channel = options.channel;
@@ -7511,14 +8397,141 @@ async function runMacAnalyze(app, config, options) {
     await session.client.close();
   }
 }
+function printAndroidElement(el) {
+  const role = import_chalk11.default.cyan(el.className);
+  const [best] = el.selectors;
+  const selectorStr = best ? import_chalk11.default.yellow(best) : import_chalk11.default.gray("(no selector)");
+  const label = el.contentDesc ?? el.text;
+  const labelStr = label ? ` ${import_chalk11.default.gray(`"${label}"`)}` : "";
+  const disabled = el.enabled === false ? import_chalk11.default.gray(" (disabled)") : "";
+  console.log(`    ${role} ${selectorStr}${labelStr}${disabled}`);
+}
+async function runAndroidAnalyze(app, config, options, deviceSerial) {
+  const allowedApps = config?.guardrails.allowedApps ?? [];
+  if (!looksLikeApk2(app)) {
+    assertAndroidAppAllowed(allowedApps, app);
+  }
+  const session = await launchAndroidSession({
+    app,
+    ...deviceSerial ? { deviceSerial } : {},
+    timeoutMs: config?.browser.timeout,
+    allowedApps
+  });
+  try {
+    const sourceFn = session.client.source;
+    if (typeof sourceFn !== "function") {
+      throw new Error(
+        "The Android agent client does not expose source(); a live uiautomator2 session is required to analyze."
+      );
+    }
+    const result = await analyzeAndroidApp(
+      { source: () => sourceFn.call(session.client) },
+      { app: session.package }
+    );
+    if (options.json) {
+      console.log(JSON.stringify(result, null, 2));
+    } else {
+      console.log(`
+  ${import_chalk11.default.bold("App Analysis:")} ${result.app}
+`);
+      if (result.elements.length > 0) {
+        console.log(import_chalk11.default.bold("  Interactive Elements:"));
+        for (const el of result.elements) {
+          printAndroidElement(el);
+        }
+        console.log();
+      }
+      console.log(import_chalk11.default.gray(`  ${result.elements.length} elements
+`));
+    }
+  } finally {
+    await session.teardown();
+  }
+}
+function printIosElement(el) {
+  const role = import_chalk11.default.cyan(el.type);
+  const [best] = el.selectors;
+  const selectorStr = best ? import_chalk11.default.yellow(best) : import_chalk11.default.gray("(no selector)");
+  const label = el.label ?? el.value ?? el.name;
+  const labelStr = label ? ` ${import_chalk11.default.gray(`"${label}"`)}` : "";
+  const disabled = el.enabled === false ? import_chalk11.default.gray(" (disabled)") : "";
+  console.log(`    ${role} ${selectorStr}${labelStr}${disabled}`);
+}
+async function runIosAnalyze(app, config, options, udid) {
+  const allowedApps = config?.guardrails.allowedApps ?? [];
+  if (!/\//.test(app) && !/\.app$/i.test(app.trim())) {
+    assertIosAppAllowed(allowedApps, app);
+  }
+  const session = await launchIosSession({
+    app,
+    ...udid ? { udid } : {},
+    timeoutMs: config?.browser.timeout,
+    allowedApps
+  });
+  try {
+    const sourceFn = session.client.source;
+    if (typeof sourceFn !== "function") {
+      throw new Error(
+        "The iOS agent client does not expose source(); a live WebDriverAgent session is required to analyze."
+      );
+    }
+    const result = await analyzeIosApp(
+      { source: () => sourceFn.call(session.client) },
+      { app: session.bundleId }
+    );
+    if (options.json) {
+      console.log(JSON.stringify(result, null, 2));
+    } else {
+      console.log(`
+  ${import_chalk11.default.bold("App Analysis:")} ${result.app}
+`);
+      if (result.windows.length > 0) {
+        console.log(import_chalk11.default.bold("  Windows:"));
+        for (const win of result.windows) {
+          const title = win.label ?? win.name;
+          const titleStr = title ? import_chalk11.default.gray(`"${title}"`) : import_chalk11.default.gray("(untitled)");
+          console.log(`    ${titleStr} ${import_chalk11.default.yellow(win.selector)}`);
+        }
+        console.log();
+      }
+      if (result.elements.length > 0) {
+        console.log(import_chalk11.default.bold("  Interactive Elements:"));
+        for (const el of result.elements) {
+          printIosElement(el);
+        }
+        console.log();
+      }
+      console.log(import_chalk11.default.gray(`  ${result.elements.length} elements, ${result.windows.length} windows
+`));
+    }
+  } finally {
+    await session.teardown();
+  }
+}
+async function runNativeAnalyze(platform, app, config, options, device) {
+  if (platform === "android") {
+    await runAndroidAnalyze(app, config, options, device.deviceSerial);
+    return;
+  }
+  if (platform === "ios") {
+    await runIosAnalyze(app, config, options, device.udid);
+    return;
+  }
+  await runMacAnalyze(app, config, options);
+}
 function buildAnalyzeCommand() {
-  const command = new import_commander8.Command("analyze").argument("[url]", "URL to analyze (web target)").description("Analyze a page or macOS app to discover interactive elements and selectors").option("--json", "Output as JSON").option("--app <app>", "macOS app to analyze: bundle id or /path/to/App.app (macOS target)").option("--browser <engine>", "Browser engine: chromium, firefox, or webkit").option("--channel <name>", "Browser channel: chrome, msedge, etc.").option("--viewport <size>", "Viewport size: WxH or preset (mobile, tablet, desktop)").option("--headed", "Show browser window").option("--config <path>", "Custom config path").action(async (url, options) => {
+  const command = new import_commander8.Command("analyze").argument("[url]", "URL to analyze (web target)").description("Analyze a page or native app to discover interactive elements and selectors").option("--json", "Output as JSON").option("--app <app>", "Native app to analyze: bundle id / package / .app / .apk (macOS, Android, or iOS)").option("--platform <name>", "Native platform for --app: macos, android, or ios (else inferred)").option("--device <serial>", "Android adb device serial (native Android target)").option("--udid <udid>", "iOS simulator UDID (native iOS target)").option("--browser <engine>", "Browser engine: chromium, firefox, or webkit").option("--channel <name>", "Browser channel: chrome, msedge, etc.").option("--viewport <size>", "Viewport size: WxH or preset (mobile, tablet, desktop)").option("--headed", "Show browser window").option("--config <path>", "Custom config path").action(async (url, options) => {
     try {
       if (options.app && url) {
-        throw new Error("Pass either a URL argument (web) or --app (macOS), not both.");
+        throw new Error("Pass either a URL argument (web) or --app (native), not both.");
       }
       if (options.app) {
-        await runMacAnalyze(options.app, tryLoadConfig(options.config), options);
+        const config2 = tryLoadConfig(options.config);
+        const platform = pickNativePlatform(options.platform, config2, options.app);
+        await runNativeAnalyze(platform, options.app, config2, options, {
+          deviceSerial: options.device,
+          udid: options.udid
+        });
         return;
       }
       if (url) {
@@ -7526,12 +8539,21 @@ function buildAnalyzeCommand() {
         return;
       }
       const config = tryLoadConfig(options.config);
-      if (config?.target.type === "macos") {
-        await runMacAnalyze(config.target.app, config, options);
+      const target = config?.target;
+      if (target?.type === "macos") {
+        await runMacAnalyze(target.app, config, options);
+        return;
+      }
+      if (target?.type === "android") {
+        await runAndroidAnalyze(target.app, config, options, options.device ?? target.deviceSerial);
+        return;
+      }
+      if (target?.type === "ios") {
+        await runIosAnalyze(target.app, config, options, options.udid ?? target.udid);
         return;
       }
       throw new Error(
-        "analyze needs a target: pass a URL for the web target, or use --app <bundle-id|.app-path> (or set target.type: macos in .prowl/config.yml) for the macOS target."
+        "analyze needs a target: pass a URL for the web target, or use --app <bundle-id|package|.app|.apk> (optionally with --platform), or set a native target.type in .prowl/config.yml."
       );
     } catch (error) {
       const message = error instanceof Error ? error.message : "Analysis failed";
@@ -7601,6 +8623,7 @@ var STEP_REFERENCE = `
 
 ### Visual Regression
 - assertScreenshot: { name: "baseline-name", threshold: 0.1 }
+- assertWithAI: "The login form should show email and password fields" \u2014 AI checks the screenshot against the claim
 
 ### Control Flow
 - if: { visible: ".banner", then: [steps...] }
@@ -7642,81 +8665,6 @@ function extractYamlFromResponse(response) {
   return response.trim();
 }
 
-// src/generator/ai.ts
-function resolveAiConfig() {
-  const provider = process.env.PROWL_AI_PROVIDER ?? "anthropic";
-  if (provider !== "anthropic" && provider !== "openai") {
-    throw new Error(`Unsupported AI provider: ${provider}. Use "anthropic" or "openai".`);
-  }
-  const apiKey = process.env.PROWL_AI_KEY;
-  if (!apiKey) {
-    throw new Error(
-      "PROWL_AI_KEY environment variable is required. Set it to your Anthropic or OpenAI API key."
-    );
-  }
-  const defaultModel = provider === "anthropic" ? "claude-sonnet-4-5-20250929" : "gpt-4o";
-  const model = process.env.PROWL_AI_MODEL ?? defaultModel;
-  return { provider, model, apiKey };
-}
-async function generateWithAi(prompt, config) {
-  if (config.provider === "anthropic") {
-    return generateWithAnthropic(prompt, config);
-  }
-  return generateWithOpenAi(prompt, config);
-}
-async function generateWithAnthropic(prompt, config) {
-  const response = await fetch("https://api.anthropic.com/v1/messages", {
-    method: "POST",
-    headers: {
-      "Content-Type": "application/json",
-      "x-api-key": config.apiKey,
-      "anthropic-version": "2023-06-01"
-    },
-    body: JSON.stringify({
-      model: config.model,
-      max_tokens: 4096,
-      messages: [
-        { role: "user", content: prompt }
-      ]
-    })
-  });
-  if (!response.ok) {
-    const body = await response.text();
-    throw new Error(`Anthropic API error (${response.status}): ${body}`);
-  }
-  const data = await response.json();
-  const textBlock = data.content.find((c) => c.type === "text");
-  if (!textBlock?.text) {
-    throw new Error("Anthropic API returned no text content");
-  }
-  return textBlock.text;
-}
-async function generateWithOpenAi(prompt, config) {
-  const response = await fetch("https://api.openai.com/v1/chat/completions", {
-    method: "POST",
-    headers: {
-      "Content-Type": "application/json",
-      "Authorization": `Bearer ${config.apiKey}`
-    },
-    body: JSON.stringify({
-      model: config.model,
-      messages: [
-        { role: "user", content: prompt }
-      ],
-      max_tokens: 4096
-    })
-  });
-  if (!response.ok) {
-    const body = await response.text();
-    throw new Error(`OpenAI API error (${response.status}): ${body}`);
-  }
-  const data = await response.json();
-  if (!data.choices?.[0]?.message?.content) {
-    throw new Error("OpenAI API returned no content");
-  }
-  return data.choices[0].message.content;
-}
-
 // src/generator/index.ts
 init_loader();
 init_schema();