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

package/dist/accname.global.js

@@ -1 +1 @@
-"use strict";(()=>{function U(e,t,i){function u(r){let o=e.__flAccName;if(o){let a=o(r);return a||t(r.placeholder)||t(r.title)||""}return b(r)}function b(r){let o=r.getAttribute&&r.getAttribute("aria-labelledby");if(o){let d=o.split(/\s+/).map(g=>document.getElementById(g)).filter(Boolean).map(g=>t(g.textContent)).filter(Boolean).join(" ");if(d)return d}let a=t(r.getAttribute&&r.getAttribute("aria-label"));if(a)return a;if(r.id){let d=document.querySelector('label[for="'+CSS.escape(r.id)+'"]');if(d&&t(d.textContent))return t(d.textContent)}let l=r.closest&&r.closest("label");if(l&&t(l.textContent))return t(l.textContent);let s=r.tagName.toLowerCase(),p=(r.type||"").toLowerCase();return(["button","a","summary"].includes(s)||r.getAttribute&&r.getAttribute("role")==="button")&&t(r.textContent)?t(r.textContent):s==="input"&&["submit","button","reset"].includes(p)&&r.value?t(r.value):t(r.placeholder)||t(r.title)||""}let S="input,select,textarea,button,meter,output,progress,[contenteditable]";function y(r){let o=r.parentElement;if(!o||!r.matches?.(S))return"";for(let a of Array.from(o.querySelectorAll("label"))){let l=a.getAttribute("for");if(l&&document.getElementById(l))continue;let s=t(a.textContent);if(s)return s}return""}let E=new WeakMap,P=crypto.randomUUID(),_=0;function T(r){let o=E.get(r);o||(o=`${P}:${++_}`,E.set(r,o));let a={__targetId:o},l=r.getRootNode(),s=r.getAttribute("data-testid");if(s&&l.querySelectorAll(`[data-testid=${JSON.stringify(s)}]`).length===1)return{...a,name:u(r),locator:{strategy:"testId",value:s}};if(r.type==="password"&&u(r))return{...a,name:u(r),locator:{strategy:"label",value:u(r)}};let p=r.getAttribute("title");if(p&&l.querySelectorAll(`[title=${JSON.stringify(p)}]`).length===1)return{...a,name:u(r),locator:{strategy:"title",value:p}};let d=u(r);if(d)return{...a,name:d};let g=y(r);if(g)return{...a,name:g,nameFrom:"adjacent-label"};let v=t(Array.from(r.childNodes||[]).filter(A=>A.nodeType===3).map(A=>A.textContent).join(" "));return v&&v.length<=80?{...a,name:v,nameFrom:"text"}:r.id&&!/:r|[a-f0-9]{12}|\d{6}/i.test(r.id)&&l.querySelectorAll(`#${CSS.escape(r.id)}`).length===1?{...a,name:"",locator:{strategy:"css",value:`#${CSS.escape(r.id)}`}}:{...a,name:""}}function N(r){let o=r.getAttribute&&r.getAttribute("role");if(o)return o;let a=r.tagName.toLowerCase(),l=(r.type||"").toLowerCase();return a==="button"?"button":a==="a"&&r.href?"link":a==="select"?r.multiple||r.size>1?"listbox":"combobox":a==="textarea"?"textbox":a==="input"?["submit","button","reset","file"].includes(l)?"button":l==="checkbox"||l==="radio"?l:l==="number"?"spinbutton":l==="search"?"searchbox":l==="range"?"slider":"textbox":r.isContentEditable?"textbox":H[a]??""}let H={li:"listitem",ul:"list",ol:"list",tr:"row",td:"cell",th:"columnheader",table:"table",nav:"navigation",main:"main",header:"banner",footer:"contentinfo",aside:"complementary",form:"form",dialog:"dialog",details:"group",fieldset:"group",img:"img",h1:"heading",h2:"heading",h3:"heading",h4:"heading",h5:"heading",h6:"heading"};function j(r){let o=r,a=null;for(let l=0;o&&l<6&&!(o===document.body||o===document.documentElement);l++){let s="";try{s=getComputedStyle(o).cursor}catch{break}if(s==="pointer")a=o;else if(a)break;o=o.parentElement}return a}let C="tr, [role=row], li, [role=listitem], [role=article], [role=gridcell]";function L(r){try{let o=r.cloneNode(!0);for(let a of Array.from(o.querySelectorAll(i+", input, select, textarea")))a.remove();for(let a of Array.from(o.querySelectorAll("td, th, li, p, div, span, tr")))a.append(" ");return t(o.textContent).slice(0,120)}catch{return""}}function D(r,o,a){if(!a)return!1;let l;try{l=Array.from(document.querySelectorAll(i+", input, select, textarea"))}catch{return!1}if(l.length>400)return!0;let s=0;for(let p of l)if(p!==r&&N(p)===o&&T(p).name===a&&++s>0)return!0;return!1}function V(r,o,a){if(!D(r,o,a))return null;let l=r.closest&&r.closest(C);if(!l)return null;let s=L(l);if(!s)return null;let p=l.getAttribute&&l.getAttribute("role"),d=l.tagName.toLowerCase();return{scope:s,scopeRole:p||(d==="tr"?"row":d==="li"?"listitem":d)}}function x(r,o,a){let l=V(r,o,a);return l||{scope:n(r)}}function n(r){let o=r.closest&&r.closest("form, fieldset, section, [role=group], [role=region], [role=dialog], [role=alertdialog], dialog");return o?u(o):""}function f(r){if(r.id)return"#"+CSS.escape(r.id);let o=[],a=r;for(;a&&a.nodeType===1&&a!==document.body;){let l=Array.from(a.parentNode?a.parentNode.children:[]).filter(s=>s.tagName===a.tagName);o.unshift(l.length>1?`${a.tagName.toLowerCase()}:nth-of-type(${l.indexOf(a)+1})`:a.tagName.toLowerCase()),a=a.parentElement}return"body > "+o.join(" > ")}return{accName:u,identify:T,roleOf:N,pointerTarget:j,scoping:x,cssPath:f}}var ge=Object.prototype.toString;function Q(e){return typeof e=="function"||ge.call(e)==="[object Function]"}function ye(e){var t=Number(e);return isNaN(t)?0:t===0||!isFinite(t)?t:(t>0?1:-1)*Math.floor(Math.abs(t))}var he=Math.pow(2,53)-1;function ve(e){var t=ye(e);return Math.min(Math.max(t,0),he)}function h(e,t){var i=Array,u=Object(e);if(e==null)throw new TypeError("Array.from requires an array-like object - not null or undefined");if(typeof t<"u"&&!Q(t))throw new TypeError("Array.from: when provided, the second argument must be a function");for(var b=ve(u.length),S=Q(i)?Object(new i(b)):new Array(b),y=0,E;y<b;)E=u[y],t?S[y]=t(E,y):S[y]=E,y+=1;return S.length=b,S}function I(e){"@babel/helpers - typeof";return I=typeof Symbol=="function"&&typeof Symbol.iterator=="symbol"?function(t){return typeof t}:function(t){return t&&typeof Symbol=="function"&&t.constructor===Symbol&&t!==Symbol.prototype?"symbol":typeof t},I(e)}function we(e,t){if(!(e instanceof t))throw new TypeError("Cannot call a class as a function")}function X(e,t){for(var i=0;i<t.length;i++){var u=t[i];u.enumerable=u.enumerable||!1,u.configurable=!0,"value"in u&&(u.writable=!0),Object.defineProperty(e,Y(u.key),u)}}function Se(e,t,i){return t&&X(e.prototype,t),i&&X(e,i),Object.defineProperty(e,"prototype",{writable:!1}),e}function Ee(e,t,i){return t=Y(t),t in e?Object.defineProperty(e,t,{value:i,enumerable:!0,configurable:!0,writable:!0}):e[t]=i,e}function Y(e){var t=xe(e,"string");return I(t)=="symbol"?t:t+""}function xe(e,t){if(I(e)!="object"||!e)return e;var i=e[Symbol.toPrimitive];if(i!==void 0){var u=i.call(e,t||"default");if(I(u)!="object")return u;throw new TypeError("@@toPrimitive must return a primitive value.")}return(t==="string"?String:Number)(e)}var Ae=(function(){function e(){var t=arguments.length>0&&arguments[0]!==void 0?arguments[0]:[];we(this,e),Ee(this,"items",void 0),this.items=t}return Se(e,[{key:"add",value:function(i){return this.has(i)===!1&&this.items.push(i),this}},{key:"clear",value:function(){this.items=[]}},{key:"delete",value:function(i){var u=this.items.length;return this.items=this.items.filter(function(b){return b!==i}),u!==this.items.length}},{key:"forEach",value:function(i){var u=this;this.items.forEach(function(b){i(b,b,u)})}},{key:"has",value:function(i){return this.items.indexOf(i)!==-1}},{key:"size",get:function(){return this.items.length}}])})(),Z=typeof Set>"u"?Set:Ae;function m(e){var t;return(t=e.localName)!==null&&t!==void 0?t:e.tagName.toLowerCase()}var Le={article:"article",aside:"complementary",button:"button",datalist:"listbox",dd:"definition",details:"group",dialog:"dialog",dt:"term",fieldset:"group",figure:"figure",form:"form",footer:"contentinfo",h1:"heading",h2:"heading",h3:"heading",h4:"heading",h5:"heading",h6:"heading",header:"banner",hr:"separator",html:"document",legend:"legend",li:"listitem",math:"math",main:"main",menu:"list",nav:"navigation",ol:"list",optgroup:"group",option:"option",output:"status",progress:"progressbar",section:"region",summary:"button",table:"table",tbody:"rowgroup",textarea:"textbox",tfoot:"rowgroup",td:"cell",th:"columnheader",thead:"rowgroup",tr:"row",ul:"list"},Te={caption:new Set(["aria-label","aria-labelledby"]),code:new Set(["aria-label","aria-labelledby"]),deletion:new Set(["aria-label","aria-labelledby"]),emphasis:new Set(["aria-label","aria-labelledby"]),generic:new Set(["aria-label","aria-labelledby","aria-roledescription"]),insertion:new Set(["aria-label","aria-labelledby"]),none:new Set(["aria-label","aria-labelledby"]),paragraph:new Set(["aria-label","aria-labelledby"]),presentation:new Set(["aria-label","aria-labelledby"]),strong:new Set(["aria-label","aria-labelledby"]),subscript:new Set(["aria-label","aria-labelledby"]),superscript:new Set(["aria-label","aria-labelledby"])};function Ne(e,t){return["aria-atomic","aria-busy","aria-controls","aria-current","aria-description","aria-describedby","aria-details","aria-dropeffect","aria-flowto","aria-grabbed","aria-hidden","aria-keyshortcuts","aria-label","aria-labelledby","aria-live","aria-owns","aria-relevant","aria-roledescription"].some(function(i){var u;return e.hasAttribute(i)&&!((u=Te[t])!==null&&u!==void 0&&u.has(i))})}function ee(e,t){return Ne(e,t)}function k(e){var t=Ie(e);if(t===null||O.indexOf(t)!==-1){var i=Ce(e);if(O.indexOf(t||"")===-1||ee(e,i||""))return i}return t}function Ce(e){var t=Le[m(e)];if(t!==void 0)return t;switch(m(e)){case"a":case"area":case"link":if(e.hasAttribute("href"))return"link";break;case"img":return e.getAttribute("alt")===""&&!ee(e,"img")?"presentation":"img";case"input":{var i=e,u=i.type;switch(u){case"button":case"image":case"reset":case"submit":return"button";case"checkbox":case"radio":return u;case"range":return"slider";case"email":case"tel":case"text":case"url":return e.hasAttribute("list")?"combobox":"textbox";case"search":return e.hasAttribute("list")?"combobox":"searchbox";case"number":return"spinbutton";default:return null}}case"select":return e.hasAttribute("multiple")||e.size>1?"listbox":"combobox"}return null}function Ie(e){var t=e.getAttribute("role");if(t!==null){var i=t.trim().split(" ")[0];if(i.length>0)return i}return null}var O=["presentation","none"];function c(e){return e!==null&&e.nodeType===e.ELEMENT_NODE}function G(e){return c(e)&&m(e)==="caption"}function R(e){return c(e)&&m(e)==="input"}function te(e){return c(e)&&m(e)==="optgroup"}function re(e){return c(e)&&m(e)==="select"}function ne(e){return c(e)&&m(e)==="table"}function ie(e){return c(e)&&m(e)==="textarea"}function ae(e){var t=e.ownerDocument===null?e:e.ownerDocument,i=t.defaultView;if(i===null)throw new TypeError("no window available");return i}function oe(e){return c(e)&&m(e)==="fieldset"}function ue(e){return c(e)&&m(e)==="legend"}function le(e){return c(e)&&m(e)==="slot"}function Oe(e){return c(e)&&e.ownerSVGElement!==void 0}function se(e){return c(e)&&m(e)==="svg"}function fe(e){return Oe(e)&&m(e)==="title"}function M(e,t){if(c(e)&&e.hasAttribute(t)){var i=e.getAttribute(t).split(" "),u=e.getRootNode?e.getRootNode():e.ownerDocument;return i.map(function(b){return u.getElementById(b)}).filter(function(b){return b!==null})}return[]}function w(e,t){return c(e)?t.indexOf(k(e))!==-1:!1}function Re(e){return e.trim().replace(/\s\s+/g," ")}function Me(e,t){if(!c(e))return!1;if(e.hasAttribute("hidden")||e.getAttribute("aria-hidden")==="true")return!0;var i=t(e);return i.getPropertyValue("display")==="none"||i.getPropertyValue("visibility")==="hidden"}function Pe(e){return w(e,["button","combobox","listbox","textbox"])||me(e,"range")}function me(e,t){if(!c(e))return!1;if(t==="range")return w(e,["meter","progressbar","scrollbar","slider","spinbutton"]);throw new TypeError("No knowledge about abstract role '".concat(t,"'. This is likely a bug :("))}function ce(e,t){var i=h(e.querySelectorAll(t));return M(e,"aria-owns").forEach(function(u){i.push.apply(i,h(u.querySelectorAll(t)))}),i}function _e(e){return re(e)?e.selectedOptions||ce(e,"[selected]"):ce(e,'[aria-selected="true"]')}function je(e){return w(e,O)}function ke(e){return G(e)}function He(e){return w(e,["button","cell","checkbox","columnheader","gridcell","heading","label","legend","link","menuitem","menuitemcheckbox","menuitemradio","option","radio","row","rowheader","switch","tab","tooltip","treeitem"])}function De(e){return!1}function Ve(e){return R(e)||ie(e)?e.value:e.textContent||""}function de(e){var t=e.getPropertyValue("content");return/^["'].*["']$/.test(t)?t.slice(1,-1):""}function pe(e){var t=m(e);return t==="button"||t==="input"&&e.getAttribute("type")!=="hidden"||t==="meter"||t==="output"||t==="progress"||t==="select"||t==="textarea"}function be(e){if(pe(e))return e;var t=null;return e.childNodes.forEach(function(i){if(t===null&&c(i)){var u=be(i);u!==null&&(t=u)}}),t}function $e(e){if(e.control!==void 0)return e.control;var t=e.getAttribute("for");return t!==null?e.ownerDocument.getElementById(t):be(e)}function qe(e){var t=e.labels;if(t===null)return t;if(t!==void 0)return h(t);if(!pe(e))return null;var i=e.ownerDocument;return h(i.querySelectorAll("label")).filter(function(u){return $e(u)===e})}function Ge(e){var t=e.assignedNodes();return t.length===0?h(e.childNodes):t}function B(e){var t=arguments.length>1&&arguments[1]!==void 0?arguments[1]:{},i=new Z,u=typeof Map>"u"?void 0:new Map,b=ae(e),S=t.compute,y=S===void 0?"name":S,E=t.computedStyleSupportsPseudoElements,P=E===void 0?t.getComputedStyle!==void 0:E,_=t.getComputedStyle,T=_===void 0?b.getComputedStyle.bind(b):_,N=t.hidden,H=N===void 0?!1:N,j=function(f,r){if(r!==void 0)throw new Error("use uncachedGetComputedStyle directly for pseudo elements");if(u===void 0)return T(f);var o=u.get(f);if(o)return o;var a=T(f,r);return u.set(f,a),a};function C(n,f){var r="";if(c(n)&&P){var o=T(n,"::before"),a=de(o);r="".concat(a," ").concat(r)}var l=le(n)?Ge(n):h(n.childNodes).concat(M(n,"aria-owns"));if(l.forEach(function(d){var g=x(d,{isEmbeddedInLabel:f.isEmbeddedInLabel,isReferenced:!1,recursion:!0}),v=c(d)?j(d).getPropertyValue("display"):"inline",A=v!=="inline"?" ":"";r+="".concat(A).concat(g).concat(A)}),c(n)&&P){var s=T(n,"::after"),p=de(s);r="".concat(r," ").concat(p)}return r.trim()}function L(n,f){var r=n.getAttributeNode(f);return r!==null&&!i.has(r)&&r.value.trim()!==""?(i.add(r),r.value):null}function D(n){return c(n)?L(n,"title"):null}function V(n){if(!c(n))return null;if(oe(n)){i.add(n);for(var f=h(n.childNodes),r=0;r<f.length;r+=1){var o=f[r];if(ue(o))return x(o,{isEmbeddedInLabel:!1,isReferenced:!1,recursion:!1})}}else if(ne(n)){i.add(n);for(var a=h(n.childNodes),l=0;l<a.length;l+=1){var s=a[l];if(G(s))return x(s,{isEmbeddedInLabel:!1,isReferenced:!1,recursion:!1})}}else if(se(n)){i.add(n);for(var p=h(n.childNodes),d=0;d<p.length;d+=1){var g=p[d];if(fe(g))return g.textContent}return null}else if(m(n)==="img"||m(n)==="area"){var v=L(n,"alt");if(v!==null)return v}else if(te(n)){var A=L(n,"label");if(A!==null)return A}if(R(n)&&(n.type==="button"||n.type==="submit"||n.type==="reset")){var z=L(n,"value");if(z!==null)return z;if(n.type==="submit")return"Submit";if(n.type==="reset")return"Reset"}var $=qe(n);if($!==null&&$.length!==0)return i.add(n),h($).map(function(q){return x(q,{isEmbeddedInLabel:!0,isReferenced:!1,recursion:!0})}).filter(function(q){return q.length>0}).join(" ");if(R(n)&&n.type==="image"){var F=L(n,"alt");if(F!==null)return F;var J=L(n,"title");return J!==null?J:"Submit Query"}if(w(n,["button"])){var K=C(n,{isEmbeddedInLabel:!1,isReferenced:!1});if(K!=="")return K}return null}function x(n,f){if(i.has(n))return"";if(!H&&Me(n,j)&&!f.isReferenced)return i.add(n),"";var r=c(n)?n.getAttributeNode("aria-labelledby"):null,o=r!==null&&!i.has(r)?M(n,"aria-labelledby"):[];if(y==="name"&&!f.isReferenced&&o.length>0)return i.add(r),o.map(function(v){return x(v,{isEmbeddedInLabel:f.isEmbeddedInLabel,isReferenced:!0,recursion:!1})}).join(" ");var a=f.recursion&&Pe(n)&&y==="name";if(!a){var l=(c(n)&&n.getAttribute("aria-label")||"").trim();if(l!==""&&y==="name")return i.add(n),l;if(!je(n)){var s=V(n);if(s!==null)return i.add(n),s}}if(w(n,["menu"]))return i.add(n),"";if(a||f.isEmbeddedInLabel||f.isReferenced){if(w(n,["combobox","listbox"])){i.add(n);var p=_e(n);return p.length===0?R(n)?n.value:"":h(p).map(function(v){return x(v,{isEmbeddedInLabel:f.isEmbeddedInLabel,isReferenced:!1,recursion:!0})}).join(" ")}if(me(n,"range"))return i.add(n),n.hasAttribute("aria-valuetext")?n.getAttribute("aria-valuetext"):n.hasAttribute("aria-valuenow")?n.getAttribute("aria-valuenow"):n.getAttribute("value")||"";if(w(n,["textbox"]))return i.add(n),Ve(n)}if(He(n)||c(n)&&f.isReferenced||ke(n)||De(n)){var d=C(n,{isEmbeddedInLabel:f.isEmbeddedInLabel,isReferenced:!1});if(d!=="")return i.add(n),d}if(n.nodeType===n.TEXT_NODE)return i.add(n),n.textContent||"";if(f.recursion)return i.add(n),C(n,{isEmbeddedInLabel:f.isEmbeddedInLabel,isReferenced:!1});var g=D(n);return g!==null?(i.add(n),g):(i.add(n),"")}return Re(x(e,{isEmbeddedInLabel:!1,isReferenced:y==="description",recursion:!1}))}function Be(e){return w(e,["caption","code","deletion","emphasis","generic","insertion","none","paragraph","presentation","strong","subscript","superscript"])}function W(e){var t=arguments.length>1&&arguments[1]!==void 0?arguments[1]:{};return Be(e)?"":B(e,t)}window.__flAccName=e=>{try{return W(e).replace(/\s+/g," ").trim()}catch{return""}};window.__flCreateTargetIdentity=U;})();
+"use strict";(()=>{function U(e,t,i){function l(n){let u=e.__flAccName;if(u){let a=u(n);return a||t(n.placeholder)||t(n.title)||""}return y(n)}function y(n){let u=n.getAttribute&&n.getAttribute("aria-labelledby");if(u){let m=u.split(/\s+/).map(b=>document.getElementById(b)).filter(Boolean).map(b=>t(b.textContent)).filter(Boolean).join(" ");if(m)return m}let a=t(n.getAttribute&&n.getAttribute("aria-label"));if(a)return a;if(n.id){let m=document.querySelector('label[for="'+CSS.escape(n.id)+'"]');if(m&&t(m.textContent))return t(m.textContent)}let o=n.closest&&n.closest("label");if(o&&t(o.textContent))return t(o.textContent);let s=n.tagName.toLowerCase(),p=(n.type||"").toLowerCase();return(["button","a","summary"].includes(s)||n.getAttribute&&n.getAttribute("role")==="button")&&t(n.textContent)?t(n.textContent):s==="input"&&["submit","button","reset"].includes(p)&&n.value?t(n.value):t(n.placeholder)||t(n.title)||""}let E="input,select,textarea,button,meter,output,progress,[contenteditable]";function v(n){let u=n.parentElement;if(!u||!n.matches?.(E))return"";for(let a of Array.from(u.querySelectorAll("label"))){let o=a.getAttribute("for");if(o&&document.getElementById(o))continue;let s=t(a.textContent);if(s)return s}return""}let x=new WeakMap,_=crypto.randomUUID(),j=0;function L(n){let u=n.getRootNode(),a=h=>u.querySelectorAll(h).length===1,o=[],s=n.getAttribute?.("data-testid");s&&a(`[data-testid=${JSON.stringify(s)}]`)&&o.push({strategy:"testId",value:s});let p=t(n.placeholder);p&&a(`[placeholder=${JSON.stringify(n.placeholder)}]`)&&o.push({strategy:"placeholder",value:p});let m=t(n.getAttribute?.("alt"));m&&a(`[alt=${JSON.stringify(n.getAttribute("alt"))}]`)&&o.push({strategy:"altText",value:m});let b=n.getAttribute?.("title");return b&&a(`[title=${JSON.stringify(b)}]`)&&o.push({strategy:"title",value:t(b)}),n.id&&!/:r|[a-f0-9]{12}|\d{6}/i.test(n.id)&&a(`#${CSS.escape(n.id)}`)&&o.push({strategy:"css",value:`#${CSS.escape(n.id)}`}),o.slice(0,4)}function C(n){let u=x.get(n);u||(u=`${_}:${++j}`,x.set(n,u));let a=L(n),o={__targetId:u,...a.length?{candidates:a}:{}},s=n.getRootNode(),p=l(n);if(p)return{...o,name:p};let m=v(n);if(m)return{...o,name:m,nameFrom:"adjacent-label"};let b=t(Array.from(n.childNodes||[]).filter(N=>N.nodeType===3).map(N=>N.textContent).join(" "));if(b&&b.length<=80)return{...o,name:b,nameFrom:"text"};let h=a[0];return h?{...o,name:"",locator:h.strategy==="placeholder"||h.strategy==="altText"?{strategy:"css",value:`[${h.strategy==="altText"?"alt":"placeholder"}=${JSON.stringify(h.value)}]`}:h}:{...o,name:""}}function k(n){let u=n.getAttribute&&n.getAttribute("role");if(u)return u;let a=n.tagName.toLowerCase(),o=(n.type||"").toLowerCase();return a==="button"?"button":a==="a"&&n.href?"link":a==="select"?n.multiple||n.size>1?"listbox":"combobox":a==="textarea"?"textbox":a==="input"?["submit","button","reset","file"].includes(o)?"button":o==="checkbox"||o==="radio"?o:o==="number"?"spinbutton":o==="search"?"searchbox":o==="range"?"slider":"textbox":n.isContentEditable?"textbox":H[a]??""}let H={li:"listitem",ul:"list",ol:"list",tr:"row",td:"cell",th:"columnheader",table:"table",nav:"navigation",main:"main",header:"banner",footer:"contentinfo",aside:"complementary",form:"form",dialog:"dialog",details:"group",fieldset:"group",img:"img",h1:"heading",h2:"heading",h3:"heading",h4:"heading",h5:"heading",h6:"heading"};function I(n){let u=n,a=null;for(let o=0;u&&o<6&&!(u===document.body||u===document.documentElement);o++){let s="";try{s=getComputedStyle(u).cursor}catch{break}if(s==="pointer")a=u;else if(a)break;u=u.parentElement}return a}let T="tr, [role=row], li, [role=listitem], [role=article], [role=gridcell]";function $(n){try{let u=n.cloneNode(!0);for(let a of Array.from(u.querySelectorAll(i+", input, select, textarea")))a.remove();for(let a of Array.from(u.querySelectorAll("td, th, li, p, div, span, tr")))a.append(" ");return t(u.textContent).slice(0,120)}catch{return""}}function V(n,u,a){if(!a)return!1;let o;try{o=Array.from(document.querySelectorAll(i+", input, select, textarea"))}catch{return!1}if(o.length>400)return!0;let s=0;for(let p of o)if(p!==n&&k(p)===u&&C(p).name===a&&++s>0)return!0;return!1}function A(n,u,a){if(!V(n,u,a))return null;let o=n.closest&&n.closest(T);if(!o)return null;let s=$(o);if(!s)return null;let p=o.getAttribute&&o.getAttribute("role"),m=o.tagName.toLowerCase();return{scope:s,scopeRole:p||(m==="tr"?"row":m==="li"?"listitem":m)}}function r(n,u,a){let o=A(n,u,a);return o||{scope:f(n)}}function f(n){let u=n.closest&&n.closest("form, fieldset, section, [role=group], [role=region], [role=dialog], [role=alertdialog], dialog");return u?l(u):""}function c(n){if(n.id)return"#"+CSS.escape(n.id);let u=[],a=n;for(;a&&a.nodeType===1&&a!==document.body;){let o=Array.from(a.parentNode?a.parentNode.children:[]).filter(s=>s.tagName===a.tagName);u.unshift(o.length>1?`${a.tagName.toLowerCase()}:nth-of-type(${o.indexOf(a)+1})`:a.tagName.toLowerCase()),a=a.parentElement}return"body > "+u.join(" > ")}return{accName:l,identify:C,roleOf:k,pointerTarget:I,scoping:r,cssPath:c}}var ge=Object.prototype.toString;function Q(e){return typeof e=="function"||ge.call(e)==="[object Function]"}function ye(e){var t=Number(e);return isNaN(t)?0:t===0||!isFinite(t)?t:(t>0?1:-1)*Math.floor(Math.abs(t))}var he=Math.pow(2,53)-1;function ve(e){var t=ye(e);return Math.min(Math.max(t,0),he)}function w(e,t){var i=Array,l=Object(e);if(e==null)throw new TypeError("Array.from requires an array-like object - not null or undefined");if(typeof t<"u"&&!Q(t))throw new TypeError("Array.from: when provided, the second argument must be a function");for(var y=ve(l.length),E=Q(i)?Object(new i(y)):new Array(y),v=0,x;v<y;)x=l[v],t?E[v]=t(x,v):E[v]=x,v+=1;return E.length=y,E}function O(e){"@babel/helpers - typeof";return O=typeof Symbol=="function"&&typeof Symbol.iterator=="symbol"?function(t){return typeof t}:function(t){return t&&typeof Symbol=="function"&&t.constructor===Symbol&&t!==Symbol.prototype?"symbol":typeof t},O(e)}function we(e,t){if(!(e instanceof t))throw new TypeError("Cannot call a class as a function")}function X(e,t){for(var i=0;i<t.length;i++){var l=t[i];l.enumerable=l.enumerable||!1,l.configurable=!0,"value"in l&&(l.writable=!0),Object.defineProperty(e,Y(l.key),l)}}function Se(e,t,i){return t&&X(e.prototype,t),i&&X(e,i),Object.defineProperty(e,"prototype",{writable:!1}),e}function Ee(e,t,i){return t=Y(t),t in e?Object.defineProperty(e,t,{value:i,enumerable:!0,configurable:!0,writable:!0}):e[t]=i,e}function Y(e){var t=xe(e,"string");return O(t)=="symbol"?t:t+""}function xe(e,t){if(O(e)!="object"||!e)return e;var i=e[Symbol.toPrimitive];if(i!==void 0){var l=i.call(e,t||"default");if(O(l)!="object")return l;throw new TypeError("@@toPrimitive must return a primitive value.")}return(t==="string"?String:Number)(e)}var Ae=(function(){function e(){var t=arguments.length>0&&arguments[0]!==void 0?arguments[0]:[];we(this,e),Ee(this,"items",void 0),this.items=t}return Se(e,[{key:"add",value:function(i){return this.has(i)===!1&&this.items.push(i),this}},{key:"clear",value:function(){this.items=[]}},{key:"delete",value:function(i){var l=this.items.length;return this.items=this.items.filter(function(y){return y!==i}),l!==this.items.length}},{key:"forEach",value:function(i){var l=this;this.items.forEach(function(y){i(y,y,l)})}},{key:"has",value:function(i){return this.items.indexOf(i)!==-1}},{key:"size",get:function(){return this.items.length}}])})(),Z=typeof Set>"u"?Set:Ae;function g(e){var t;return(t=e.localName)!==null&&t!==void 0?t:e.tagName.toLowerCase()}var Te={article:"article",aside:"complementary",button:"button",datalist:"listbox",dd:"definition",details:"group",dialog:"dialog",dt:"term",fieldset:"group",figure:"figure",form:"form",footer:"contentinfo",h1:"heading",h2:"heading",h3:"heading",h4:"heading",h5:"heading",h6:"heading",header:"banner",hr:"separator",html:"document",legend:"legend",li:"listitem",math:"math",main:"main",menu:"list",nav:"navigation",ol:"list",optgroup:"group",option:"option",output:"status",progress:"progressbar",section:"region",summary:"button",table:"table",tbody:"rowgroup",textarea:"textbox",tfoot:"rowgroup",td:"cell",th:"columnheader",thead:"rowgroup",tr:"row",ul:"list"},Le={caption:new Set(["aria-label","aria-labelledby"]),code:new Set(["aria-label","aria-labelledby"]),deletion:new Set(["aria-label","aria-labelledby"]),emphasis:new Set(["aria-label","aria-labelledby"]),generic:new Set(["aria-label","aria-labelledby","aria-roledescription"]),insertion:new Set(["aria-label","aria-labelledby"]),none:new Set(["aria-label","aria-labelledby"]),paragraph:new Set(["aria-label","aria-labelledby"]),presentation:new Set(["aria-label","aria-labelledby"]),strong:new Set(["aria-label","aria-labelledby"]),subscript:new Set(["aria-label","aria-labelledby"]),superscript:new Set(["aria-label","aria-labelledby"])};function Ne(e,t){return["aria-atomic","aria-busy","aria-controls","aria-current","aria-description","aria-describedby","aria-details","aria-dropeffect","aria-flowto","aria-grabbed","aria-hidden","aria-keyshortcuts","aria-label","aria-labelledby","aria-live","aria-owns","aria-relevant","aria-roledescription"].some(function(i){var l;return e.hasAttribute(i)&&!((l=Le[t])!==null&&l!==void 0&&l.has(i))})}function ee(e,t){return Ne(e,t)}function D(e){var t=Ie(e);if(t===null||R.indexOf(t)!==-1){var i=Ce(e);if(R.indexOf(t||"")===-1||ee(e,i||""))return i}return t}function Ce(e){var t=Te[g(e)];if(t!==void 0)return t;switch(g(e)){case"a":case"area":case"link":if(e.hasAttribute("href"))return"link";break;case"img":return e.getAttribute("alt")===""&&!ee(e,"img")?"presentation":"img";case"input":{var i=e,l=i.type;switch(l){case"button":case"image":case"reset":case"submit":return"button";case"checkbox":case"radio":return l;case"range":return"slider";case"email":case"tel":case"text":case"url":return e.hasAttribute("list")?"combobox":"textbox";case"search":return e.hasAttribute("list")?"combobox":"searchbox";case"number":return"spinbutton";default:return null}}case"select":return e.hasAttribute("multiple")||e.size>1?"listbox":"combobox"}return null}function Ie(e){var t=e.getAttribute("role");if(t!==null){var i=t.trim().split(" ")[0];if(i.length>0)return i}return null}var R=["presentation","none"];function d(e){return e!==null&&e.nodeType===e.ELEMENT_NODE}function B(e){return d(e)&&g(e)==="caption"}function M(e){return d(e)&&g(e)==="input"}function te(e){return d(e)&&g(e)==="optgroup"}function re(e){return d(e)&&g(e)==="select"}function ne(e){return d(e)&&g(e)==="table"}function ie(e){return d(e)&&g(e)==="textarea"}function ae(e){var t=e.ownerDocument===null?e:e.ownerDocument,i=t.defaultView;if(i===null)throw new TypeError("no window available");return i}function oe(e){return d(e)&&g(e)==="fieldset"}function ue(e){return d(e)&&g(e)==="legend"}function le(e){return d(e)&&g(e)==="slot"}function Oe(e){return d(e)&&e.ownerSVGElement!==void 0}function se(e){return d(e)&&g(e)==="svg"}function fe(e){return Oe(e)&&g(e)==="title"}function P(e,t){if(d(e)&&e.hasAttribute(t)){var i=e.getAttribute(t).split(" "),l=e.getRootNode?e.getRootNode():e.ownerDocument;return i.map(function(y){return l.getElementById(y)}).filter(function(y){return y!==null})}return[]}function S(e,t){return d(e)?t.indexOf(D(e))!==-1:!1}function Re(e){return e.trim().replace(/\s\s+/g," ")}function Me(e,t){if(!d(e))return!1;if(e.hasAttribute("hidden")||e.getAttribute("aria-hidden")==="true")return!0;var i=t(e);return i.getPropertyValue("display")==="none"||i.getPropertyValue("visibility")==="hidden"}function Pe(e){return S(e,["button","combobox","listbox","textbox"])||pe(e,"range")}function pe(e,t){if(!d(e))return!1;if(t==="range")return S(e,["meter","progressbar","scrollbar","slider","spinbutton"]);throw new TypeError("No knowledge about abstract role '".concat(t,"'. This is likely a bug :("))}function ce(e,t){var i=w(e.querySelectorAll(t));return P(e,"aria-owns").forEach(function(l){i.push.apply(i,w(l.querySelectorAll(t)))}),i}function _e(e){return re(e)?e.selectedOptions||ce(e,"[selected]"):ce(e,'[aria-selected="true"]')}function je(e){return S(e,R)}function ke(e){return B(e)}function He(e){return S(e,["button","cell","checkbox","columnheader","gridcell","heading","label","legend","link","menuitem","menuitemcheckbox","menuitemradio","option","radio","row","rowheader","switch","tab","tooltip","treeitem"])}function De(e){return!1}function $e(e){return M(e)||ie(e)?e.value:e.textContent||""}function de(e){var t=e.getPropertyValue("content");return/^["'].*["']$/.test(t)?t.slice(1,-1):""}function me(e){var t=g(e);return t==="button"||t==="input"&&e.getAttribute("type")!=="hidden"||t==="meter"||t==="output"||t==="progress"||t==="select"||t==="textarea"}function be(e){if(me(e))return e;var t=null;return e.childNodes.forEach(function(i){if(t===null&&d(i)){var l=be(i);l!==null&&(t=l)}}),t}function Ve(e){if(e.control!==void 0)return e.control;var t=e.getAttribute("for");return t!==null?e.ownerDocument.getElementById(t):be(e)}function qe(e){var t=e.labels;if(t===null)return t;if(t!==void 0)return w(t);if(!me(e))return null;var i=e.ownerDocument;return w(i.querySelectorAll("label")).filter(function(l){return Ve(l)===e})}function Ge(e){var t=e.assignedNodes();return t.length===0?w(e.childNodes):t}function J(e){var t=arguments.length>1&&arguments[1]!==void 0?arguments[1]:{},i=new Z,l=typeof Map>"u"?void 0:new Map,y=ae(e),E=t.compute,v=E===void 0?"name":E,x=t.computedStyleSupportsPseudoElements,_=x===void 0?t.getComputedStyle!==void 0:x,j=t.getComputedStyle,L=j===void 0?y.getComputedStyle.bind(y):j,C=t.hidden,k=C===void 0?!1:C,H=function(f,c){if(c!==void 0)throw new Error("use uncachedGetComputedStyle directly for pseudo elements");if(l===void 0)return L(f);var n=l.get(f);if(n)return n;var u=L(f,c);return l.set(f,u),u};function I(r,f){var c="";if(d(r)&&_){var n=L(r,"::before"),u=de(n);c="".concat(u," ").concat(c)}var a=le(r)?Ge(r):w(r.childNodes).concat(P(r,"aria-owns"));if(a.forEach(function(p){var m=A(p,{isEmbeddedInLabel:f.isEmbeddedInLabel,isReferenced:!1,recursion:!0}),b=d(p)?H(p).getPropertyValue("display"):"inline",h=b!=="inline"?" ":"";c+="".concat(h).concat(m).concat(h)}),d(r)&&_){var o=L(r,"::after"),s=de(o);c="".concat(c," ").concat(s)}return c.trim()}function T(r,f){var c=r.getAttributeNode(f);return c!==null&&!i.has(c)&&c.value.trim()!==""?(i.add(c),c.value):null}function $(r){return d(r)?T(r,"title"):null}function V(r){if(!d(r))return null;if(oe(r)){i.add(r);for(var f=w(r.childNodes),c=0;c<f.length;c+=1){var n=f[c];if(ue(n))return A(n,{isEmbeddedInLabel:!1,isReferenced:!1,recursion:!1})}}else if(ne(r)){i.add(r);for(var u=w(r.childNodes),a=0;a<u.length;a+=1){var o=u[a];if(B(o))return A(o,{isEmbeddedInLabel:!1,isReferenced:!1,recursion:!1})}}else if(se(r)){i.add(r);for(var s=w(r.childNodes),p=0;p<s.length;p+=1){var m=s[p];if(fe(m))return m.textContent}return null}else if(g(r)==="img"||g(r)==="area"){var b=T(r,"alt");if(b!==null)return b}else if(te(r)){var h=T(r,"label");if(h!==null)return h}if(M(r)&&(r.type==="button"||r.type==="submit"||r.type==="reset")){var N=T(r,"value");if(N!==null)return N;if(r.type==="submit")return"Submit";if(r.type==="reset")return"Reset"}var q=qe(r);if(q!==null&&q.length!==0)return i.add(r),w(q).map(function(G){return A(G,{isEmbeddedInLabel:!0,isReferenced:!1,recursion:!0})}).filter(function(G){return G.length>0}).join(" ");if(M(r)&&r.type==="image"){var z=T(r,"alt");if(z!==null)return z;var F=T(r,"title");return F!==null?F:"Submit Query"}if(S(r,["button"])){var K=I(r,{isEmbeddedInLabel:!1,isReferenced:!1});if(K!=="")return K}return null}function A(r,f){if(i.has(r))return"";if(!k&&Me(r,H)&&!f.isReferenced)return i.add(r),"";var c=d(r)?r.getAttributeNode("aria-labelledby"):null,n=c!==null&&!i.has(c)?P(r,"aria-labelledby"):[];if(v==="name"&&!f.isReferenced&&n.length>0)return i.add(c),n.map(function(b){return A(b,{isEmbeddedInLabel:f.isEmbeddedInLabel,isReferenced:!0,recursion:!1})}).join(" ");var u=f.recursion&&Pe(r)&&v==="name";if(!u){var a=(d(r)&&r.getAttribute("aria-label")||"").trim();if(a!==""&&v==="name")return i.add(r),a;if(!je(r)){var o=V(r);if(o!==null)return i.add(r),o}}if(S(r,["menu"]))return i.add(r),"";if(u||f.isEmbeddedInLabel||f.isReferenced){if(S(r,["combobox","listbox"])){i.add(r);var s=_e(r);return s.length===0?M(r)?r.value:"":w(s).map(function(b){return A(b,{isEmbeddedInLabel:f.isEmbeddedInLabel,isReferenced:!1,recursion:!0})}).join(" ")}if(pe(r,"range"))return i.add(r),r.hasAttribute("aria-valuetext")?r.getAttribute("aria-valuetext"):r.hasAttribute("aria-valuenow")?r.getAttribute("aria-valuenow"):r.getAttribute("value")||"";if(S(r,["textbox"]))return i.add(r),$e(r)}if(He(r)||d(r)&&f.isReferenced||ke(r)||De(r)){var p=I(r,{isEmbeddedInLabel:f.isEmbeddedInLabel,isReferenced:!1});if(p!=="")return i.add(r),p}if(r.nodeType===r.TEXT_NODE)return i.add(r),r.textContent||"";if(f.recursion)return i.add(r),I(r,{isEmbeddedInLabel:f.isEmbeddedInLabel,isReferenced:!1});var m=$(r);return m!==null?(i.add(r),m):(i.add(r),"")}return Re(A(e,{isEmbeddedInLabel:!1,isReferenced:v==="description",recursion:!1}))}function Be(e){return S(e,["caption","code","deletion","emphasis","generic","insertion","none","paragraph","presentation","strong","subscript","superscript"])}function W(e){var t=arguments.length>1&&arguments[1]!==void 0?arguments[1]:{};return Be(e)?"":J(e,t)}window.__flAccName=e=>{try{return W(e).replace(/\s+/g," ").trim()}catch{return""}};window.__flCreateTargetIdentity=U;})();

package/dist/{chunk-ZVX26LV7.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.20";
+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-ZRUZU4TI.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"]),
@@ -524,7 +524,32 @@ var RecordedTargetSchema = z3.object({
   frame: z3.array(z3.string()).optional(),
   pageId: z3.string().optional(),
   nameFrom: z3.enum(["adjacent-label", "text"]).optional(),
+  /** SET BY A PERSON, and exclusive.
+   *
+   * Somebody opened the editor and said "find it this way instead", which is
+   * a decision about semantics that were wrong for this element. Falling back
+   * to those semantics would undo it, so this replaces resolution entirely.
+   *
+   * Steps recorded before `candidates` existed also carry the recorder's own
+   * pick here, and are treated the same way: nothing in the document says
+   * which of the two put it there, and guessing wrong in the other direction
+   * would change what somebody's test does. */
   locator: LocatorOverrideSchema.optional(),
+  /** WHAT THE RECORDER SAW, best first — preferences, not assertions.
+   *
+   * One locator is one way to be wrong. A test id is removed, a placeholder
+   * is reworded, a wrapper is added, and a step that had exactly one way to
+   * 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 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()
 });
 var RecordedAssertionKindSchema = z3.enum([
@@ -918,11 +943,57 @@ var FlowOccurrenceSchema = z22.object({
   startPath: z22.string().optional(),
   baseUrl: z22.string().url().optional(),
   /** GO SOMEWHERE FIRST, or carry on where the last row ended.
+   *
+   * SUPERSEDED BY `start`, and still read so that every case written before
+   * it keeps running unchanged. `startOf` answers for both shapes; nothing
+   * should consult this field directly.
    *
    * Off by default, because a case is a sequence in one browser: re-entering
    * each flow's original starting URL would sign the tester out between rows
    * and is exactly the behaviour composing flows is meant to avoid. */
   navigateFirst: z22.boolean().default(false),
+  /** WHICH BROWSER THIS ROW RUNS IN.
+   *
+   * Two answers, because there are two: carry on in the browser this
+   * participant already has, or open them a new one. Where the page goes is a
+   * different question with its own field — folding them together produced a
+   * three-way choice in which two of the answers differed by something most
+   * people never set.
+   *
+   * A case is a sequence of flows performed by participants, and until now
+   * the only question a row could answer was whether to navigate. Whether it
+   * ran in the participant's EXISTING browser or a fresh one could not be
+   * said at all — it was implied (always the existing one) and could only be
+   * overridden by burying a `resetActor` step inside the flow.
+   *
+   *   continue — the participant's browser, exactly where they left it
+   *   navigate — the participant's browser, back at this flow's start path
+   *   fresh    — a new browser for them, signed in again if they start signed
+   *              in, then the start path
+   *
+   * A participant's FIRST row is always fresh in effect: there is nothing to
+   * continue from. That is not stored, because it is a fact about the order
+   * rather than about the row — moving the row changes the answer. */
+  start: z22.enum(["continue", "navigate", "fresh"]).optional(),
+  /** WHETHER THIS COPY DOES ITS OWN SIGNING IN.
+   *
+   * A flow recorded with "sign in before recording" keeps that sign-in as its
+   * first step, because that is how it readies ITSELF when it runs alone.
+   * Inside a case the identity belongs to the person, so the same step is
+   * usually a second answer to a question already answered.
+   *
+   *   skip — the person's account is the one used; this copy's own sign-ins
+   *          lie dormant, and the run confirms the session rather than
+   *          assuming it
+   *   run  — perform them anyway, whoever they name. Signing in as somebody
+   *          else on this person's browser is a real thing to want, and
+   *          before this there was no way to say it.
+   *
+   * ABSENT IS NOT "run". It is "nobody has said", which behaves as skip where
+   * the two agree on the account and is refused where they do not — so a case
+   * written before this keeps its meaning, and a contradiction stays a
+   * contradiction until somebody actually resolves it. */
+  ownSignIn: z22.enum(["skip", "run"]).optional(),
   steps: z22.array(RecordedStepSchema),
   environment: ExecutionEnvironmentSchema.optional(),
   /** Where this copy came from, so the editor can say whether the source has
@@ -954,8 +1025,18 @@ var TestCaseSchema = z22.object({
   slug: z22.string().regex(/^[a-z0-9][a-z0-9-]*$/),
   name: z22.string().min(1),
   description: z22.string().default(""),
-  /** Where the case itself begins. The first row continues from here unless it
-   *  carries its own navigation. */
+  /** NO LONGER USED, and kept only so that a case written while they were
+   *  parses.
+   *
+   * These overrode the FIRST row's start path — whichever row that happened
+   * to be. A case is reordered by dragging, so the override silently moved to
+   * whatever was dragged to the top, carrying a path chosen for a different
+   * flow. Nothing said so, and the row it landed on looked like every other
+   * row. A positional override of a list people reorder is a setting that
+   * cannot stay correct.
+   *
+   * Every row now starts where its own flow says, which is the same answer
+   * whatever the order. */
   startPath: z22.string().default("/"),
   useStartPath: z22.boolean().default(false),
   baseUrl: z22.string().url().optional(),
@@ -984,6 +1065,11 @@ var TestCaseSchema = z22.object({
       steps.add(step.id);
     });
   });
+}).transform((testCase) => {
+  if (!testCase.defaultActorId || testCase.defaultActorId === "default") return testCase;
+  if (testCase.actors?.some((actor) => actor.id === testCase.defaultActorId)) return testCase;
+  const { defaultActorId: _gone, ...rest } = testCase;
+  return rest;
 });
 var CaseFolderSchema = z22.object({
   schemaVersion: z22.literal(1),
@@ -1035,13 +1121,66 @@ var SuiteSchema = z22.object({
     seen.add(entry.entryId);
   });
 });
-function caseOccurrences(testCase) {
-  return testCase.occurrences.map((item, index) => index === 0 && testCase.useStartPath && !item.navigateFirst ? { ...item, startPath: testCase.startPath, ...testCase.baseUrl ? { baseUrl: testCase.baseUrl } : {} } : item);
+function startOf(occurrence) {
+  return occurrence.start === "fresh" ? "fresh" : "continue";
+}
+function navigatesFirst(occurrence) {
+  return occurrence.start === "navigate" || occurrence.navigateFirst;
+}
+function sessionLanes(occurrences, defaultActorId) {
+  const mine = /* @__PURE__ */ new Map();
+  const owner = /* @__PURE__ */ new Map();
+  const incarnations = /* @__PURE__ */ new Map();
+  const lanes = /* @__PURE__ */ new Map();
+  const last = /* @__PURE__ */ new Map();
+  const rows = [];
+  let previous = null;
+  const open = (actorId) => {
+    const next = (incarnations.get(actorId) ?? -1) + 1;
+    incarnations.set(actorId, next);
+    const sessionId = `${actorId}#${next}`;
+    mine.set(actorId, sessionId);
+    owner.set(sessionId, actorId);
+    if (!lanes.has(sessionId)) lanes.set(sessionId, lanes.size);
+    return sessionId;
+  };
+  for (const occurrence of occurrences) {
+    const actorId = occurrence.actorId || defaultActorId || "default";
+    const continues = startOf(occurrence) === "continue";
+    const asked = occurrence.start === "continue";
+    const theirs = mine.get(actorId);
+    const adoptable = previous !== null && owner.get(previous) === "default" && actorId !== "default";
+    let sessionId;
+    if (continues && theirs) sessionId = theirs;
+    else if (asked && adoptable) {
+      sessionId = previous;
+      owner.set(sessionId, actorId);
+      mine.set(actorId, sessionId);
+      mine.delete("default");
+    } else sessionId = open(actorId);
+    const continuesFrom = last.get(sessionId) ?? null;
+    rows.push({
+      occurrenceId: occurrence.occurrenceId,
+      actorId,
+      incarnation: Number(sessionId.split("#")[1]),
+      sessionId,
+      lane: lanes.get(sessionId),
+      continuesFrom,
+      opens: continuesFrom === null,
+      // WHETHER THERE IS A CHOICE TO MAKE. A row with nothing to continue —
+      // no browser of their own and no guest's to take over — is told so
+      // rather than offered an answer that cannot mean anything.
+      mayContinue: Boolean(theirs) || adoptable
+    });
+    last.set(sessionId, occurrence.occurrenceId);
+    previous = sessionId;
+  }
+  return rows;
 }
 function caseDebugPlan(testCase, baseUrl) {
   const owners = {};
   const steps = [];
-  const occurrences = caseOccurrences(testCase);
+  const occurrences = testCase.occurrences;
   for (const [index, item] of occurrences.entries()) {
     if (testCase.actors?.length) {
       const id = `case-actor:${encodeURIComponent(item.occurrenceId)}`;
@@ -1244,14 +1383,19 @@ function validateActors(actors = [], defaultId = "default", used = []) {
     ids.add(actor.id);
   }
   for (const id of [defaultId, ...used]) {
-    if (id === UNSET_ACTOR) throw new Error("A participant step does not say which participant \u2014 choose one before running");
-    if (id && !ids.has(id)) throw new Error(`Unknown actor: ${id} \u2014 configure this participant before running`);
+    if (id === UNSET_ACTOR) throw new Error("A step does not say who it is for \u2014 choose somebody before running");
+    if (id && !ids.has(id)) throw new Error(`This test names somebody it does not have (${id}) \u2014 choose who runs that row before running`);
   }
 }
 var UNSET_ACTOR = "\0unset";
 function actorIdsUsed(steps) {
   return steps.flatMap((step) => step.disabled ? [] : step.type === "useActor" ? [step.actorId ?? UNSET_ACTOR] : step.type === "resetActor" && step.actorId ? [step.actorId] : []);
 }
+function sameIdentity(a, b2) {
+  if (a.profileId !== b2.profileId) return false;
+  if (a.accountId && b2.accountId) return a.accountId === b2.accountId;
+  return true;
+}
 
 // ../engine-playwright/dist/index.js
 import { createHmac, randomBytes } from "crypto";
@@ -1328,34 +1472,36 @@ function resolveStartUrl(baseUrl, startPath) {
 }
 var INPUT_ROLES = /* @__PURE__ */ new Set(["textbox", "combobox", "checkbox", "radio", "spinbutton", "searchbox"]);
 var NAVIGATIONS = /* @__PURE__ */ new Set(["back", "forward"]);
-function locatorPlan(step) {
-  const o = step.locator;
+function planForOverride(o, overridden) {
   if (o && o.value.trim()) {
     const value = o.value.trim();
     switch (o.strategy) {
       // Playwright reads a leading `xpath=` prefix, and also bare paths that
       // start with `/` or `//`. Normalising here means the QA can paste either.
       case "xpath":
-        return { method: "locator", arg: value.startsWith("xpath=") ? value : `xpath=${value}`, overridden: true };
+        return { method: "locator", arg: value.startsWith("xpath=") ? value : `xpath=${value}`, overridden };
       // Typed as a bare id, so nobody has to remember the `#`.
       case "id":
-        return { method: "locator", arg: /^[a-zA-Z_][a-zA-Z0-9_-]*$/.test(value.replace(/^#/, "")) ? `#${value.replace(/^#/, "")}` : `[id=${JSON.stringify(value.replace(/^#/, ""))}]`, overridden: true };
+        return { method: "locator", arg: /^[a-zA-Z_][a-zA-Z0-9_-]*$/.test(value.replace(/^#/, "")) ? `#${value.replace(/^#/, "")}` : `[id=${JSON.stringify(value.replace(/^#/, ""))}]`, overridden };
       case "css":
-        return { method: "locator", arg: value, overridden: true };
+        return { method: "locator", arg: value, overridden };
       case "testId":
-        return { method: "getByTestId", arg: value, overridden: true };
+        return { method: "getByTestId", arg: value, overridden };
       case "text":
-        return { method: "getByText", arg: value, exact: true, overridden: true };
+        return { method: "getByText", arg: value, exact: true, overridden };
       case "label":
-        return { method: "getByLabel", arg: value, exact: true, overridden: true };
+        return { method: "getByLabel", arg: value, exact: true, overridden };
       case "placeholder":
-        return { method: "getByPlaceholder", arg: value, exact: true, overridden: true };
+        return { method: "getByPlaceholder", arg: value, exact: true, overridden };
       case "altText":
-        return { method: "getByAltText", arg: value, exact: true, overridden: true };
+        return { method: "getByAltText", arg: value, exact: true, overridden };
       case "title":
-        return { method: "getByTitle", arg: value, exact: true, overridden: true };
+        return { method: "getByTitle", arg: value, exact: true, overridden };
     }
   }
+  return null;
+}
+function semanticPlan(step) {
   if (NAVIGATIONS.has(step.type)) {
     return { method: step.type === "back" ? "goBack" : "goForward", arg: "", overridden: false };
   }
@@ -1380,6 +1526,49 @@ function locatorPlan(step) {
   }
   return INPUT_ROLES.has(step.role) ? { method: "getByLabel", arg: step.name, exact: true, overridden: false, inputRole: step.role } : step.role ? { method: "getByRole", arg: step.role, name: step.name, exact: true, overridden: false } : { method: "getByText", arg: step.name, exact: step.type !== "hover", overridden: false, visible: true };
 }
+function locatorPlans(step) {
+  const chosen = planForOverride(step.locator, true);
+  if (chosen) return [chosen];
+  const candidates = step.candidates ?? [];
+  const plans = [
+    ...candidates.filter((each) => each.strategy === "testId"),
+    ...candidates.filter((each) => each.strategy !== "testId")
+  ];
+  const first = plans.findIndex((each) => each.strategy !== "testId");
+  const before = first === -1 ? plans : plans.slice(0, first);
+  const after = first === -1 ? [] : plans.slice(first);
+  const semantic = semanticPlan(step);
+  const ordered = [
+    ...before.map((each) => planForOverride(each, false)),
+    // Below a test id and above everything else. A name is what somebody
+    // reading the test understands the step to be about, so a step that
+    // resolves by it is the step still meaning what it says.
+    semantic.method === "none" ? null : semantic,
+    ...after.map((each) => planForOverride(each, false))
+  ].filter((plan) => plan !== null);
+  return ordered.length ? ordered : [semantic];
+}
+var quote = (s2) => `'${s2.replace(/\\/g, "\\\\").replace(/'/g, "\\'")}'`;
+function locatorPlan(step) {
+  return locatorPlans(step)[0];
+}
+function describeLocators(step) {
+  return locatorPlans(step).map((plan) => describePlan(step, plan));
+}
+function describePlan(step, p) {
+  if (p.method === "none") return "(nothing to resolve \u2014 no accessible name)";
+  if (p.method === "goBack") return "page.goBack()";
+  if (p.method === "goForward") return "page.goForward()";
+  let root = "page";
+  for (const frame of step.frame ?? []) root += `.frameLocator(${quote(frameSelector(frame))})`;
+  if (!p.overridden && step.scope) root = scopeExpression(root, step.scope, step.scopeRole);
+  let base = p.viaAdjacentLabel ? `${root}.getByText(${quote(p.arg)}, { exact: true }).locator('xpath=..').getByRole(${quote(step.role || "textbox")})` : p.method === "getByRole" ? `${root}.getByRole(${quote(p.arg)}, { name: ${quote(p.name ?? "")}, exact: true })` : `${root}.${p.method}(${quote(p.arg)}${p.exact !== void 0 ? `, { exact: ${p.exact} }` : ""})`;
+  if (p.inputRole) base = `${root}.getByRole(${quote(p.inputRole)}, { name: ${quote(p.arg)}, exact: true }).or(${base}.and(${root}.locator(${quote(inputSelector(p.inputRole))})))`;
+  if (p.visible) base += ".filter({ visible: true })";
+  if (step.nth !== void 0) base += `.nth(${step.nth})`;
+  if (step.pageId && step.pageId !== "main") base += `  // page ${quote(step.pageId)}`;
+  return base;
+}
 function frameSelector(name) {
   const positional = /^nth:(\d+)$/.exec(name);
   if (positional) return `iframe, frame >> nth=${positional[1]}`;
@@ -1390,6 +1579,10 @@ function inputSelector(role) {
   return role === "textbox" ? 'input, textarea, [contenteditable="true"], [role="textbox"]' : `input, select, [role="${role}"]`;
 }
 var SCOPE_ROLES = ["form", "group", "region", "dialog", "alertdialog"];
+function scopeExpression(root, name, role) {
+  const parts = (role ? [role] : SCOPE_ROLES).map((r) => `${root}.getByRole(${quote(r)}, { name: ${quote(name)}, exact: ${!role} })`);
+  return parts.reduce((a, b2) => `${a}.or(${b2})`);
+}
 var CHECKS = [
   { id: "visible", label: "is visible", kind: "visible", group: "state" },
   { id: "not-visible", label: "is not visible", kind: "visible", not: true, group: "state" },
@@ -3105,6 +3298,30 @@ var RunActors = class {
     if (!id || id === "default") return this.opts.actors?.find((a) => a.id === (id ?? "default"))?.name ?? "the main participant";
     return this.opts.actors?.find((a) => a.id === id)?.name ?? id;
   }
+  /** WHAT THIS PARTICIPANT STARTS AS, if anything.
+   *
+   * Asked by a `signIn` step before it runs: a flow carries its own sign-in
+   * because that is how it gets itself ready when it runs ALONE, and in a
+   * case the person is already that identity. Running it again logs in on top
+   * of a session that is already signed in, which most applications answer by
+   * redirecting away from the login page — so the form is not there and a
+   * correctly signed-in run goes red. */
+  identityOf(id) {
+    return this.opts.actors?.find((a) => a.id === (id ?? "default"))?.startSignedIn;
+  }
+  /** SIGN THIS PERSON IN AGAIN, in the browser they already have.
+   *
+   * Not `freshGuest`, which is the opposite: that throws the context away to
+   * start somebody over as a stranger, and leaves them one. This is for a
+   * session that has simply gone — expired, or dropped by the application —
+   * where the browser is the right browser and only the sign-in is missing.
+   *
+   * Un-initialising is what makes `select` do the preparation again rather
+   * than assume it already happened. */
+  async prepareAgain(id) {
+    this.initialized.delete(id);
+    await this.select(id);
+  }
   async select(id, startUrl = this.opts.startUrl) {
     const actor = this.opts.actors?.find((a) => a.id === id);
     if (id !== "default" && !actor) throw new Error(`Unknown actor: ${id}`);
@@ -3170,6 +3387,42 @@ var RunActors = class {
     }
     this.initialized.add(id);
   }
+  /** START THIS PARTICIPANT AGAIN, as themselves.
+   *
+   * `freshGuest` gives a browser that has never been anywhere, which is the
+   * right answer for "start over as a stranger" and the wrong one for "Alice
+   * on a second device": it would leave Alice signed out for the rest of the
+   * case. So the context is replaced AND the participant is un-initialised,
+   * which is what makes `select` navigate and run their sign-in again.
+   *
+   * The distinction is the whole difference between a row that says `fresh`
+   * and a `resetActor` step, and both are worth having. */
+  async restart(id, startUrl) {
+    await this.freshGuest(id);
+    this.initialized.delete(id);
+    await this.select(id, startUrl);
+  }
+  /** HAND A GUEST'S BROWSER TO SOMEBODY, and sign them in there.
+   *
+   * Browsing as a guest and then signing in is one browser, not two: the
+   * basket filled before signing in is the whole point of testing it, and a
+   * participant given a browser of their own would never see it.
+   *
+   * The context is moved rather than copied — there is one of it — and the
+   * participant is left un-initialised so `select` navigates and runs their
+   * sign-in inside it. The guest keeps no claim on it; a later guest row
+   * opens a browser of its own, because this one is signed in now. */
+  async adopt(from, to, startUrl) {
+    const session = this.sessions.get(from);
+    if (!session) return this.select(to, startUrl);
+    this.sessions.set(to, session);
+    this.sessions.delete(from);
+    this.initialized.delete(from);
+    this.initialized.delete(to);
+    this.current = session;
+    this.currentId = to;
+    await this.select(to, startUrl);
+  }
   /** Replace a participant's context without disturbing anyone else's. */
   async replaceWithGuest(id, previous) {
     const session = await openRunSession({ ...this.opts, browser: this.main.browser, ...this.evidenceIn(`actor-${id}`) });
@@ -3189,6 +3442,10 @@ var RunActors = class {
   preparedHow() {
     return Object.fromEntries(this.preparations);
   }
+  /** Whether this participant already has a browser open. */
+  has(id) {
+    return this.sessions.has(id);
+  }
   /** Throw this participant's session away and give them a new signed-out one.
    *
    * NOT SIGNING OUT. An application can be signed out of while the browser
@@ -3553,8 +3810,15 @@ async function locate(page, step, opts = {}) {
   const loc = await locateAll(page, step, opts);
   return step.nth === void 0 ? loc : loc.nth(step.nth);
 }
+async function locateCandidates(page, step, opts = {}) {
+  const built = [];
+  for (const plan of locatorPlans(step)) built.push(await fromPlan(page, step, plan, opts));
+  return step.nth === void 0 ? built : built.map((each) => each.nth(step.nth));
+}
 async function locateAll(page, step, opts = {}) {
-  const plan = locatorPlan(step);
+  return fromPlan(page, step, locatorPlan(step), opts);
+}
+async function fromPlan(page, step, plan, opts = {}) {
   let root = rootFor(page, step);
   if (step.scope && !plan.overridden) {
     const roles = step.scopeRole ? [step.scopeRole] : [...SCOPE_ROLES];
@@ -4036,6 +4300,7 @@ async function performSignIn(session, step, opts) {
   }
   return { ok: true, label, detail: null, kind: null, checks: checked?.checks ?? [] };
 }
+var SIGNED_IN_CHECK_MS = 3e3;
 async function confirmSignedIn(page, auth, timeoutMs) {
   for (const check of auth.success) {
     if (check.enabled === false) continue;
@@ -4150,6 +4415,67 @@ async function runStepsIn(session, steps, opts) {
         error = "the run was cancelled";
         break;
       }
+      if (step.type === "signIn" && !step.disabled && step.auth && opts.actors && opts.ownSignIn !== "run") {
+        const identity = opts.actors.identityOf(opts.actors.currentId);
+        const auth = opts.resolveAuth?.(step.auth);
+        const dormant = opts.ownSignIn === "skip" || identity !== void 0 && sameIdentity(identity, step.auth);
+        const expected = identity && !sameIdentity(identity, step.auth) ? opts.resolveAuth?.(identity) : auth;
+        if (identity && auth && expected && hasSuccessCheck(expected) && dormant) {
+          const started = Date.now();
+          if ((await confirmSignedIn(session.page, expected, SIGNED_IN_CHECK_MS)).ok) {
+            const provided = {
+              stepId: step.id,
+              name: `Sign in as ${expected.accountName}`,
+              type: step.type,
+              value: null,
+              secret: false,
+              status: "skipped",
+              detail: `${opts.actors.nameOf(opts.actors.currentId)} already starts signed in as ${expected.accountName}`,
+              failureKind: null,
+              durationMs: Date.now() - started,
+              checks: []
+            };
+            results.push(provided);
+            onStepResult?.(provided);
+            continue;
+          }
+          if (!sameIdentity(identity, step.auth)) {
+            const started2 = Date.now();
+            const who = opts.actors.currentId;
+            let recovered = null;
+            try {
+              await opts.actors.prepareAgain(who);
+              session = opts.actors.current;
+              ({ page, pages, config, artifacts } = session);
+              if (!(await confirmSignedIn(session.page, expected, SIGNED_IN_CHECK_MS)).ok) {
+                recovered = "signing them in again did not take";
+              }
+            } catch (failure) {
+              recovered = firstLine2(failure);
+            }
+            const outcome = {
+              stepId: step.id,
+              name: `Sign in as ${expected.accountName}`,
+              type: step.type,
+              value: null,
+              secret: false,
+              status: recovered ? "failed" : "skipped",
+              detail: recovered ? `this row uses ${opts.actors.nameOf(who)}'s own sign-in rather than its own, and ${recovered}` : `${opts.actors.nameOf(who)} was signed in again as ${expected.accountName}`,
+              failureKind: recovered ? "unknown" : null,
+              durationMs: Date.now() - started2,
+              checks: []
+            };
+            results.push(outcome);
+            onStepResult?.(outcome);
+            if (recovered) {
+              status2 = "failed";
+              error = `${outcome.name}: ${outcome.detail}`;
+              break;
+            }
+            continue;
+          }
+        }
+      }
       if ((step.type === "signIn" || step.type === "signOut") && !step.disabled) {
         const started = Date.now();
         const outcome = await performSignIn(session, step, opts);
@@ -4217,7 +4543,13 @@ async function runStepsIn(session, steps, opts) {
           baseUrl: opts.baseUrl,
           ...opts.actors ? { actors: opts.actors } : {},
           timeoutMs: config.timeoutMs,
-          navigationTimeoutMs: config.navigationTimeoutMs
+          navigationTimeoutMs: config.navigationTimeoutMs,
+          // SAID OUT LOUD, on a step that passed. The element was found, but
+          // not the way this step says it should be — something has moved,
+          // and the run is the only place anybody would learn it.
+          onFallback: (_step, foundBy) => {
+            result.foundBy = foundBy;
+          }
         });
         for (const a of step.proposals ?? []) {
           if (a.enabled === false) continue;
@@ -4424,8 +4756,9 @@ async function executeStep(main, input, options = {}) {
     if (step.scroll && step.type !== "scroll") {
       await applyScroll(page, step, Math.min(2e3, remaining()));
     }
-    const loc = await locate(page, step);
-    await ensureTarget(page, loc, step, remaining());
+    const target = await ensureTarget(page, step, remaining());
+    const loc = target.loc;
+    if (target.foundBy) options.onFallback?.(step, target.foundBy);
     page.setDefaultTimeout(remaining());
     await applyAction(loc, step, value, { resolveFile: options.resolveFile, dropTarget: await locateDrop(page, step) });
   };
@@ -4477,21 +4810,38 @@ async function applyScroll(page, step, timeout) {
   } catch {
   }
 }
-async function ensureTarget(page, loc, step, timeout) {
+async function ensureTarget(page, step, timeout) {
+  const candidates = await locateCandidates(page, step);
+  const described = describeLocators(step);
+  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 loc.waitFor({ state: "attached", timeout: firstWait });
-    return;
+    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 && !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, loc, recovery)) return;
+  if (await scrollUntilFound(page, primary, recovery)) return { loc: primary };
   throw Object.assign(
     new Error(
-      `no element named "${step.name}" \u2014 nothing on this page matches the target or its recorded scope`
+      candidates.length > 1 ? `no element named "${step.name}" \u2014 none of the ${candidates.length} ways this step records it match anything on the page` : `no element named "${step.name}" \u2014 nothing on this page matches the target or its recorded scope`
     ),
     { kind: "not_found" }
   );
@@ -4533,6 +4883,7 @@ async function replayCase(opts) {
   const outcomes = [];
   let status2 = "passed";
   let error = null;
+  const lanes = sessionLanes(occurrences, opts.defaultActorId);
   try {
     for (const [index, occurrence] of occurrences.entries()) {
       if (status2 !== "passed" || opts.signal?.aborted) {
@@ -4555,9 +4906,15 @@ async function replayCase(opts) {
         opts.onOccurrenceResult?.(skipped);
         continue;
       }
-      const navigates = occurrence.navigateFirst;
+      const navigates = navigatesFirst(occurrence);
+      const who = occurrence.actorId ?? opts.defaultActorId ?? "default";
+      const entry = resolveStartUrl(occurrence.baseUrl ?? baseUrl, occurrence.startPath ?? "/");
+      const plan = lanes[index];
       try {
-        await actors.select(occurrence.actorId ?? opts.defaultActorId ?? "default", resolveStartUrl(occurrence.baseUrl ?? baseUrl, occurrence.startPath ?? "/"));
+        if (plan.opens && startOf(occurrence) === "fresh") await actors.restart(who, entry);
+        else if (plan.opens) await actors.select(who, entry);
+        else if (actors.currentId !== who && !actors.has(who)) await actors.adopt("default", who, entry);
+        else await actors.select(who, entry);
       } catch (failure) {
         status2 = "failed";
         error = failure.message;
@@ -4570,6 +4927,7 @@ async function replayCase(opts) {
         baseUrl: occurrence.baseUrl ?? baseUrl,
         ...opts.resolveAuth ? { resolveAuth: opts.resolveAuth } : {},
         stepOffset: outcomes.reduce((count, previous) => count + previous.stepsTotal, 0),
+        ...occurrence.ownSignIn ? { ownSignIn: occurrence.ownSignIn } : {},
         ...opts.resolveSecret === void 0 ? {} : { resolveSecret: opts.resolveSecret },
         ...opts.resolveFile === void 0 ? {} : { resolveFile: opts.resolveFile },
         ...opts.evidenceDir === void 0 ? {} : { evidenceDir: opts.evidenceDir },
@@ -4833,6 +5191,7 @@ async function startRecordingSession(opts) {
       ...payload.frame?.length ? { frame: payload.frame } : {},
       ...payload.to ? { to: payload.to } : {},
       ...payload.locator ? { locator: payload.locator } : {},
+      ...payload.candidates?.length ? { candidates: payload.candidates } : {},
       ...payload.values ? { values: payload.values } : {},
       ...payload.warning ? { warning: payload.warning } : {},
       ...payload.pageId ? { pageId: payload.pageId } : {},
@@ -5045,6 +5404,7 @@ async function startRecordingSession(opts) {
         ...parsed.target?.scopeRole ? { scopeRole: parsed.target.scopeRole } : {},
         ...parsed.target?.frame?.length ? { frame: parsed.target.frame } : {},
         ...parsed.target?.locator ? { locator: parsed.target.locator } : {},
+        ...parsed.target?.candidates?.length ? { candidates: parsed.target.candidates } : {},
         ...parsed.target?.pageId ? { pageId: parsed.target.pageId } : {},
         value: "",
         secret: false,
@@ -5676,7 +6036,7 @@ async function startDebugSession(opts) {
   return session;
 }
 
-// ../results/dist/chunk-WEBNFZEW.js
+// ../results/dist/chunk-LYCTVHPR.js
 import { z as z5 } from "zod";
 var RunStatusSchema = z5.enum([
   "queued",
@@ -5744,6 +6104,13 @@ var RunStepSchema = z5.object({
   status: z5.enum(["passed", "failed", "skipped"]),
   failureKind: FailureKindSchema.nullable(),
   detail: z5.string().nullable(),
+  /** WHICH WAY FOUND IT, when the first way did not.
+   *
+   * A step carries several routes to its element and takes the first that
+   * matches. Passing on a later one is not a failure, but it does mean the
+   * page has moved under the step — and a suite that repairs itself quietly
+   * drifts away from the application it tests. Null is the ordinary case. */
+  foundBy: z5.string().nullable().default(null),
   durationMs: z5.number().int().nonnegative().nullable(),
   /** Where the browser was when this step ran. Recorded on failure, and
    * frequently the whole answer — the element is missing because a step
@@ -6004,6 +6371,16 @@ var MIGRATIONS2 = [
   `
   ALTER TABLE run_step ADD COLUMN value TEXT;
   ALTER TABLE run_step ADD COLUMN secret INTEGER NOT NULL DEFAULT 0;
+  `,
+  // 5 — a step that found its element some way other than the first it tried.
+  //
+  // Nullable, and NULL is the ordinary case: the step was found the way it
+  // says it should be. It is recorded because the alternative is a suite that
+  // repairs itself quietly and drifts away from the application it tests —
+  // and because "which steps are limping?" is a question about history, not
+  // about the run somebody happens to be watching.
+  `
+  ALTER TABLE run_step ADD COLUMN found_by TEXT;
   `
 ];
 var SCHEMA_VERSION = MIGRATIONS2.length;
@@ -6216,8 +6593,8 @@ var SqliteStorage = class {
       this.handle.prepare(
         `INSERT INTO run_step (id, run_task_id, ordinal, step_id, action, target_role,
              target_name, target_scope, status, failure_kind, detail, duration_ms,
-             page_url, page_title, value, secret)
-           VALUES (?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?)`
+             page_url, page_title, value, secret, found_by)
+           VALUES (?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?)`
       ).run(
         id,
         taskId,
@@ -6235,7 +6612,8 @@ var SqliteStorage = class {
         input.pageTitle ?? null,
         // Never the plaintext. A secret arrives here already withheld.
         input.secret ? null : input.value ?? null,
-        b(input.secret ?? false)
+        b(input.secret ?? false),
+        input.foundBy ?? null
       );
       const stmt = this.handle.prepare(
         `INSERT INTO run_check (id, run_step_id, assertion_id, kind, expected, actual, ok, soft, detail)
@@ -6379,6 +6757,7 @@ var SqliteStorage = class {
         durationMs: n(st.duration_ms),
         pageUrl: s(st.page_url),
         pageTitle: s(st.page_title),
+        foundBy: s(st.found_by),
         checks: checksByStep.get(String(st.id)) ?? []
       });
       stepsByTask.set(String(st.run_task_id), list);
@@ -7519,6 +7898,9 @@ function toStepRow(ordinal, result, step) {
     durationMs: result.durationMs,
     pageUrl: result.evidence?.url ?? null,
     pageTitle: result.evidence?.title ?? null,
+    // Kept, because "which steps are limping?" is a question about history
+    // rather than about the run somebody happens to be watching.
+    foundBy: result.foundBy ?? null,
     checks
   };
 }
@@ -7585,7 +7967,7 @@ async function executeCase(opts) {
   let outcome;
   try {
     outcome = await replayCase({
-      occurrences: caseOccurrences(testCase),
+      occurrences: testCase.occurrences,
       ...testCase.actors ? { actors: testCase.actors } : {},
       ...testCase.defaultActorId ? { defaultActorId: testCase.defaultActorId } : {},
       resolveAuth: authenticationResolver(opts.authentications),

package/dist/cli.js

@@ -8,7 +8,7 @@ import {
   resolveCheckouts,
   start,
   status
-} from "./chunk-ZVX26LV7.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-ZVX26LV7.js";
+} from "./chunk-O3S4QSN4.js";
 export {
   AGENT_VERSION,
   browsersReady,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@flowriki/agent",
-  "version": "0.1.0-beta.20",
+  "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",