@flowriki/agent 0.1.0-beta.21 → 0.1.0-beta.22

package/dist/{chunk-U3QYIAXF.js → chunk-O3S4QSN4.js}

@@ -6,7 +6,7 @@ import os from "os";
 import path from "path";
 import { createRequire } from "module";
 import { spawnSync } from "child_process";
-var AGENT_VERSION = "0.1.0-beta.21";
+var AGENT_VERSION = "0.1.0-beta.22";
 async function prepareBrowsers() {
   if (browsersReady()) {
     return { ok: true, already: true, message: "chromium is already installed" };
@@ -458,7 +458,7 @@ import path7 from "path";
 // ../engine-playwright/dist/index.js
 import path3 from "path";
 
-// ../test-model/dist/chunk-RQ5E3H3R.js
+// ../test-model/dist/chunk-X4X4KGMA.js
 import { z as z3 } from "zod";
 var LocatorOverrideSchema = z3.object({
   strategy: z3.enum(["css", "xpath", "id", "testId", "text", "label", "placeholder", "altText", "title"]),
@@ -542,11 +542,13 @@ var RecordedTargetSchema = z3.object({
    * find its element has none — although the field is sitting in plain sight
    * and two other things about it are unchanged.
    *
-   * Tried in order, and ONLY where the one before found nothing. Two matches
-   * is a question the test has to answer, never one to guess at, so ambiguity
-   * stops the walk rather than passing it along. A step that resolves by
-   * anything other than its first choice says so in the result — a repair
-   * nobody can see is a repair nobody can trust. */
+   * Tried in order, and ONLY where the one before did not identify a single
+   * element. EXACTLY ONE MATCH WINS: a locator matching several is
+   * disqualified rather than obeyed, so choosing between two elements never
+   * happens — and where nothing identifies one, the run stops and names the
+   * ambiguity. A step that resolves by anything other than its first choice
+   * says so in the result: a repair nobody can see is a repair nobody can
+   * trust. */
   candidates: z3.array(LocatorOverrideSchema).max(4).optional(),
   nth: z3.number().int().nonnegative().optional()
 });
@@ -4814,25 +4816,27 @@ async function ensureTarget(page, step, timeout) {
   const primary = candidates[0];
   const firstWait = Math.max(500, Math.floor(timeout * 0.45));
   const recovery = Math.max(1e3, Math.floor(timeout * 0.35));
+  let several = null;
   try {
     await primary.waitFor({ state: "attached", timeout: firstWait });
     return { loc: primary };
   } catch (error) {
-    if (/strict mode violation/.test(String(error))) {
-      throw Object.assign(error, { kind: "ambiguous" });
-    }
+    if (/strict mode violation/.test(String(error))) several = error;
   }
+  let crowded = null;
   for (let at = 1; at < candidates.length; at += 1) {
     const found = await candidates[at].count().catch(() => 0);
     if (found === 1) return { loc: candidates[at], foundBy: described[at] ?? "another locator" };
-    if (found > 1) {
-      throw Object.assign(
-        new Error(
-          `"${step.name}" could not be found the way this step records it, and ${found} elements match ${described[at]} \u2014 narrow it in the editor`
-        ),
-        { kind: "ambiguous" }
-      );
-    }
+    if (found > 1 && !crowded) crowded = { where: described[at] ?? "another locator", count: found };
+  }
+  if (several) throw Object.assign(several, { kind: "ambiguous" });
+  if (crowded) {
+    throw Object.assign(
+      new Error(
+        `"${step.name}" could not be found the way this step records it, and ${crowded.count} elements match ${crowded.where} \u2014 nothing this step knows tells them apart, so narrow it in the editor`
+      ),
+      { kind: "ambiguous" }
+    );
   }
   if (await scrollUntilFound(page, primary, recovery)) return { loc: primary };
   throw Object.assign(

package/dist/cli.js

@@ -8,7 +8,7 @@ import {
   resolveCheckouts,
   start,
   status
-} from "./chunk-U3QYIAXF.js";
+} from "./chunk-O3S4QSN4.js";
 
 // src/cli.ts
 import { parseArgs } from "util";

package/dist/engine.js

@@ -9,7 +9,7 @@ import {
   resolveCheckouts,
   start,
   status
-} from "./chunk-U3QYIAXF.js";
+} from "./chunk-O3S4QSN4.js";
 export {
   AGENT_VERSION,
   browsersReady,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@flowriki/agent",
-  "version": "0.1.0-beta.21",
+  "version": "0.1.0-beta.22",
   "description": "Run Flowriki UI tests on your own computer. Connects this machine to your Flowriki account.",
   "license": "SEE LICENSE IN LICENSE",
   "type": "module",