@avasapp/agent-bridge 0.3.0 → 0.4.1

package/dist/adapters/react-native-webview.cjs

@@ -0,0 +1,672 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/adapters/react-native-webview.ts
+var react_native_webview_exports = {};
+__export(react_native_webview_exports, {
+  useWebViewTools: () => useWebViewTools,
+  webviewTools: () => webviewTools
+});
+module.exports = __toCommonJS(react_native_webview_exports);
+var import_react = require("react");
+
+// src/runtime/screen/settle.ts
+var STATE = /* @__PURE__ */ Symbol.for("@avasapp/agent-bridge/commits");
+var UPDATE_LANES = (1 << 22) - 1;
+var hook = () => globalThis.__REACT_DEVTOOLS_GLOBAL_HOOK__;
+var now = () => performance.now();
+function install() {
+  const h = hook();
+  if (!h) return null;
+  const current = h.onCommitFiberRoot;
+  const existing = current?.[STATE];
+  if (existing) return existing;
+  const state = { commits: 0, listeners: /* @__PURE__ */ new Set() };
+  const wrapped = function(...args) {
+    state.commits += 1;
+    for (const listener of state.listeners) {
+      try {
+        listener();
+      } catch {
+      }
+    }
+    return current?.apply(this, args);
+  };
+  Object.defineProperty(wrapped, STATE, { value: state });
+  h.onCommitFiberRoot = wrapped;
+  return state;
+}
+function busy() {
+  const h = hook();
+  if (!h?.renderers || !h.getFiberRoots) return false;
+  for (const id of h.renderers.keys()) {
+    for (const root of h.getFiberRoots(id)) {
+      const pending = root.pendingLanes;
+      if (typeof pending !== "number") continue;
+      if (pending & ~(root.suspendedLanes ?? 0) & UPDATE_LANES) return true;
+    }
+  }
+  return false;
+}
+var frame = () => new Promise((resolve) => {
+  const raf = globalThis.requestAnimationFrame;
+  if (raf) raf(() => resolve());
+  else setTimeout(resolve, 16);
+});
+async function settle(options = {}) {
+  const maxMs = options.maxMs ?? 500;
+  const t0 = now();
+  const state = install();
+  const start = state?.commits ?? 0;
+  const result = () => ({
+    commits: (state?.commits ?? 0) - start,
+    ms: Math.round((now() - t0) * 100) / 100
+  });
+  await new Promise((resolve) => setTimeout(resolve, 0));
+  if (!state) return result();
+  let seen = state.commits;
+  if (seen === start && !busy()) return result();
+  while (now() - t0 < maxMs) {
+    await frame();
+    if (state.commits === seen && !busy()) break;
+    seen = state.commits;
+  }
+  return result();
+}
+
+// src/runtime/logs.ts
+var STATE2 = /* @__PURE__ */ Symbol.for("@avasapp/agent-bridge/logs");
+function logToBridge(level, message, env = globalThis) {
+  const state = env[STATE2];
+  state?.capture.record(level, [message]);
+}
+
+// src/runtime/screen/webview-mark.ts
+var escape = (name) => encodeURIComponent(name).replace(/\*/g, "%2A");
+var webViewMark = (name) => `/*agent-bridge:webview:${escape(name)}*/`;
+
+// src/adapters/webview-page.generated.ts
+var PAGE_BUNDLE = '(function(){"use strict";var __agentBridgePage=(()=>{var F=Object.defineProperty;var ee=Object.getOwnPropertyDescriptor;var te=Object.getOwnPropertyNames;var ne=Object.prototype.hasOwnProperty;var oe=(s,E)=>{for(var S in E)F(s,S,{get:E[S],enumerable:!0})},re=(s,E,S,f)=>{if(E&&typeof E=="object"||typeof E=="function")for(let y of te(E))!ne.call(s,y)&&y!==S&&F(s,y,{get:()=>E[y],enumerable:!(f=ee(E,y))||f.enumerable});return s};var ie=s=>re(F({},"__esModule",{value:!0}),s);var ce={};oe(ce,{bootMain:()=>se,pageMain:()=>ae});function se(s,E,S){if(s.__agentBridgeBoot)return;s.__agentBridgeBoot=!0;let f=s.JSON.stringify.bind(s.JSON),y=[],k=()=>{try{if(!s.ReactNativeWebView)return!1;for(;y.length;)E(y.shift());return!0}catch{return!0}},$=l=>{y.push(f({__agentBridge:1,t:S,...l})),k()};if(!k()){let l=0,m=s.setInterval(()=>{(k()||++l>400)&&s.clearInterval(m)},25)}s.document.addEventListener("DOMContentLoaded",k);let N=()=>({url:String(s.location.href),origin:String(s.location.origin)}),v=l=>$({kind:"state",state:l,...N()}),L=l=>{if(typeof l=="string")return l;if(l&&typeof l=="object"&&"message"in l){let m=l,x=`${m.name||"Error"}: ${m.message}`;return m.stack&&m.stack.startsWith(x)?m.stack:m.stack?`${x}\n${m.stack}`:x}try{let m=f(l);return m===void 0?String(l):m}catch{return String(l)}},A=l=>$({kind:"log",level:"error",message:l.slice(0,2e3)}),R=s.console.error;s.console.error=function(...l){return A(l.map(L).join(" ")),R.apply(this,l)},s.addEventListener("error",l=>{l.error?A(`Uncaught ${L(l.error)}`):A(`Uncaught ${l.message} (${l.filename}:${l.lineno})`)}),s.addEventListener("unhandledrejection",l=>A(`Unhandled promise rejection: ${L(l.reason)}`)),v("loading"),s.addEventListener("load",()=>v("loaded")),s.addEventListener("popstate",()=>v("navigated")),s.addEventListener("hashchange",()=>v("navigated"));for(let l of["pushState","replaceState"]){let m=s.history[l];s.history[l]=function(...x){let T=m.apply(this,x);return v("navigated"),T}}}function ae(s,E,S){let f=JSON.parse(E),y=String(s.location.origin),k=(e,t)=>{try{S(JSON.stringify(e?{__agentBridge:1,t:f.token,kind:"reply",nonce:f.nonce,origin:y,ok:e,result:t}:{__agentBridge:1,t:f.token,kind:"reply",nonce:f.nonce,origin:y,ok:e,error:t}))}catch{}},$=e=>k(!1,e instanceof Error?e.message:String(e));if(!f.allowed.includes(y)){k(!1,`Origin ${y} is not allowed (allowed: ${f.allowed.join(", ")||"none"})`);return}let N=s.document,v=["data-testid","data-test-id","data-cy"],L=["SCRIPT","STYLE","NOSCRIPT","TEMPLATE","HEAD","META","LINK","DATALIST"],A=["SPAN","B","I","EM","STRONG","SMALL","CODE","MARK","SUB","SUP","U","S","ABBR","CITE","Q","TIME"],R=["button","link","menuitem","tab","checkbox","switch","radio","option","menuitemcheckbox","menuitemradio"],l=["textbox","searchbox","combobox"],m=["button","submit","reset","image"],x=["testID","label","placeholder","text","role","index"],T=e=>(e||"").replace(/\\s+/g," ").trim(),b=(e,t)=>e.getAttribute(t),_=e=>{if(e.hidden||b(e,"aria-hidden")==="true")return!0;try{let t=s.getComputedStyle(e);return t.display==="none"||t.visibility==="hidden"}catch{return!1}},M=e=>{for(let t of v){let n=b(e,t);if(n)return n}},K=e=>Array.from(e.childNodes).some(t=>t.nodeType===3&&T(t.nodeValue)),B=new WeakSet,J=(e,t)=>{let n=[];for(let o of Array.from(e.childNodes))o.nodeType===3?n.push(o.nodeValue):o.nodeType===1&&A.includes(o.tagName)&&!M(o)&&!b(o,"aria-label")&&!b(o,"role")&&!_(o)&&(t&&B.add(o),n.push(J(o,t)));return T(n.join(" "))},X=e=>{let t=e.tagName,n=b(e,"role");if(t==="TEXTAREA"||t==="SELECT")return"input";if(t==="INPUT"){let r=String(e.type||"text").toLowerCase();return r==="hidden"?null:m.includes(r)||r==="checkbox"||r==="radio"?"button":"input"}let o=b(e,"contenteditable");return o===""||o==="true"||n&&l.includes(n)?"input":t==="BUTTON"||t==="SUMMARY"||t==="A"&&b(e,"href")!==null||n&&R.includes(n)?"button":null},W=e=>{let t=b(e,"role");if(t)return t;let n=e.tagName;if(n==="A")return"link";if(n==="BUTTON")return"button";if(n==="SELECT")return"combobox";if(n==="TEXTAREA")return"textbox";if(n==="INPUT"){let o=String(e.type||"text").toLowerCase();return o==="checkbox"||o==="radio"?o:m.includes(o)?"button":"textbox"}},Y=e=>{let t=b(e,"aria-label");if(t)return t;let n=e.tagName;if(n!=="INPUT"&&n!=="TEXTAREA"&&n!=="SELECT")return;let o="";try{if(o=T(e.labels&&e.labels[0]?e.labels[0].textContent:""),!o&&e.id){let r=N.querySelector(`label[for="${String(e.id).replace(/"/g,\'\\\\"\')}"]`);o=T(r?r.textContent:"")}}catch{}return o||void 0},D=e=>e==="true"?!0:e==="false"?!1:e==="mixed"?"mixed":void 0,P=(e,t,n,o)=>{let r={kind:t,rect:null},i=M(e);i&&(r.testID=i),n&&(r.text=n);let a=Y(e);a&&(r.label=a);let g=b(e,"placeholder");g&&(r.placeholder=g);let d=t==="text"?b(e,"role")||void 0:W(e);d&&(r.role=d);let u=e.tagName,h=String(e.type||"").toLowerCase();if(u==="SELECT"&&(r.options=Array.from(e.options).map(p=>{let H={value:String(p.value),label:T(p.label||p.textContent)};return p.selected&&(H.selected=!0),H})),t==="input"&&(u==="INPUT"||u==="TEXTAREA"||u==="SELECT"?(h==="password"?e.value&&(r.value="[hidden]"):r.value=String(e.value),r.editable=!(e.readOnly||e.disabled)):r.value=T(e.textContent),r.editable===void 0&&(r.editable=!0)),u==="INPUT"&&(h==="checkbox"||h==="radio"))r.checked=!!e.checked;else{let p=D(b(e,"aria-checked"));p!==void 0&&(r.checked=p)}let c=D(b(e,"aria-selected"));c!==void 0&&c!=="mixed"&&(r.selected=c);let w=D(b(e,"aria-expanded"));w!==void 0&&w!=="mixed"&&(r.expanded=w),(e.disabled===!0||b(e,"aria-disabled")==="true")&&(r.disabled=!0),o&&(r.frame=o);try{let p=e.getBoundingClientRect();r.rect={x:Math.round(p.x),y:Math.round(p.y),width:Math.round(p.width),height:Math.round(p.height)}}catch{}return r},O=()=>{let e=[],t=(n,o,r)=>{for(let i of Array.from(n.children)){if(L.includes(i.tagName)||_(i))continue;let a=i.tagName;if(a==="IFRAME"||a==="FRAME"){let c=null;try{c=i.contentDocument,c&&c.location.href}catch{c=null}let w=M(i)||b(i,"name")||b(i,"id")||String(e.length);if(c&&c.documentElement)t(c.documentElement,!1,w);else{let p=P(i,"iframe",void 0,r);p.note="iframe (cross-origin, not reachable)",e.push({info:p,el:i,hasText:!1})}continue}let g=X(i),d=B.has(i),u=!1;if(g){let c=g==="button"?T(a==="INPUT"?i.value:i.textContent):void 0;e.push({info:P(i,g,c||void 0,r),el:i,hasText:!!c}),u=!0}else if(!o&&!d&&K(i)){let c=J(i,!0);c&&(e.push({info:P(i,"text",c,r),el:i,hasText:!0}),u=!0)}if(!u&&!d&&(M(i)||b(i,"aria-label"))&&e.push({info:P(i,"view",void 0,r),el:i,hasText:!1}),a==="SELECT")continue;let h=o||g==="button";i.shadowRoot&&t(i.shadowRoot,h,r),t(i,h,r)}};return t(N.documentElement,!1),e},I=e=>{let t=o=>o.length>40?`${o.slice(0,39)}\\u2026`:o;if(e.note)return e.note;let n=[(e.checked!==void 0||e.selected!==void 0||e.expanded!==void 0)&&e.role||e.kind];return e.testID&&n.push(`#${e.testID}`),e.text&&n.push(JSON.stringify(t(e.text))),e.label&&e.label!==e.text&&n.push(`label=${JSON.stringify(t(e.label))}`),e.placeholder&&n.push(`placeholder=${JSON.stringify(t(e.placeholder))}`),e.value!==void 0&&n.push(`value=${JSON.stringify(t(e.value))}`),e.checked!==void 0&&n.push(e.checked===!0?"checked":e.checked===!1?"unchecked":"mixed"),e.selected!==void 0&&n.push(e.selected?"selected":"unselected"),e.expanded!==void 0&&n.push(e.expanded?"expanded":"collapsed"),e.disabled&&n.push("disabled"),n.join(" ")},C=e=>JSON.stringify(e),q=(e,t)=>{if(typeof t!="string"){if(t===null||typeof t!="object"||Array.isArray(t))throw new Error(`A target is a string or an object with ${x.join(", ")}; got ${JSON.stringify(t)}`);let i=Object.keys(t).filter(a=>!x.includes(a));if(i.length)throw new Error(`Unknown target key ${i.map(a=>JSON.stringify(a)).join(", ")}. Valid keys: ${x.join(", ")}`)}let n=i=>i.info.kind==="view"&&!i.info.testID&&!i.info.text&&!i.info.placeholder,o;if(typeof t=="string"){let i=t.toLowerCase();o=[a=>a.testID===t,a=>a.label===t,a=>a.placeholder===t,a=>a.text===t,a=>!!a.text&&a.text.includes(t),a=>!!a.role&&a.role.toLowerCase()===i]}else{let{testID:i,label:a,placeholder:g,text:d,role:u}=t,h=c=>(i===void 0||c.testID===i)&&(a===void 0||c.label===a)&&(g===void 0||c.placeholder===g)&&(u===void 0||!!c.role&&c.role.toLowerCase()===u.toLowerCase());o=d===void 0?[h]:[c=>h(c)&&c.text===d,c=>h(c)&&!!c.text&&c.text.includes(d)]}let r=e.filter(i=>i.info.kind!=="iframe");for(let i of[r.filter(a=>!n(a)),r.filter(n)])for(let a of o){let g=i.filter(d=>a(d.info));if(g.length)return g}return[]},U=(e,t=15)=>{let n=e.slice(0,t).map(o=>I(o.info));return e.length>t&&n.push(`+${e.length-t} more`),n.length?n.join("; "):"nothing"},V=(e,t,n)=>{let o=O(),r=q(o,e);if(!r.length)throw new Error(`Nothing in the page matches ${C(e)}. On the page: ${U(o)}`);let i=r.filter(t);i.length&&(r=i);let a=n??(typeof e=="object"?e.index:void 0);if(a!==void 0){let g=r[a];if(!g)throw new Error(`${C(e)} has ${r.length} match(es); index ${a} is out of range`);return g}if(r.length>1){let g=r.slice(0,10).map((d,u)=>`${u}: ${I(d.info)}`).join("; ");throw new Error(`${C(e)} matches ${r.length} elements; pick one with an index, e.g. {"index":1} as the last argument, or use a narrower target. ${g}`)}return r[0]},j=()=>new Promise(e=>{let t=Date.now(),n=!1,o=!1,r,i,a=null,g=u=>{n||(n=!0,clearTimeout(r),clearTimeout(i),a&&a.disconnect(),e({ms:Date.now()-t,capped:u}))};i=setTimeout(()=>g(!0),2e3);let d=()=>{if(o||n)return;o=!0;let u=()=>{clearTimeout(r),r=setTimeout(()=>g(!1),100)};try{a=new s.MutationObserver(u);let h={subtree:!0,childList:!0,attributes:!0,characterData:!0},c=w=>{a.observe(w,h);for(let p of Array.from(w.querySelectorAll("*")))if(p.shadowRoot&&c(p.shadowRoot),p.tagName==="IFRAME"||p.tagName==="FRAME")try{p.contentDocument&&p.contentDocument.documentElement&&c(p.contentDocument)}catch{}};c(N)}catch{}u()};typeof s.requestAnimationFrame=="function"&&s.requestAnimationFrame(d),setTimeout(d,100)}),G=e=>new Promise(t=>setTimeout(t,e)),Q=e=>{try{e.scrollIntoView&&e.scrollIntoView({block:"center",inline:"center"})}catch{}let t={bubbles:!0,cancelable:!0,composed:!0,view:s};typeof s.PointerEvent=="function"&&e.dispatchEvent(new s.PointerEvent("pointerdown",t)),e.dispatchEvent(new s.MouseEvent("mousedown",t)),typeof e.focus=="function"&&e.focus(),typeof s.PointerEvent=="function"&&e.dispatchEvent(new s.PointerEvent("pointerup",t)),e.dispatchEvent(new s.MouseEvent("mouseup",t)),e.click()},z=(e,t)=>{let n=e.tagName;if(n==="INPUT"||n==="TEXTAREA"||n==="SELECT"){let o=n==="INPUT"?s.HTMLInputElement:n==="TEXTAREA"?s.HTMLTextAreaElement:s.HTMLSelectElement,r=Object.getOwnPropertyDescriptor(o.prototype,"value")?.set;r?r.call(e,t):e.value=t}else e.textContent=t},Z=async()=>{let e=f.options||{};if(f.op==="snapshot"){let t=O().map(n=>n.info);return{url:String(s.location.href),title:String(N.title||""),elements:t}}if(f.op==="press"){let t=V(f.target,o=>o.info.kind==="button",e.index);if(t.info.disabled&&!e.force)throw new Error(`${I(t.info)} is disabled; pass {"force":true} to press it anyway`);Q(t.el);let n=await j();return{element:t.info,settled:n}}if(f.op==="fill"){let t=V(f.target,d=>d.info.kind==="input",e.index);if(t.info.kind!=="input")throw new Error(`${I(t.info)} is not an input; webview.press it instead`);if(t.info.editable===!1)throw new Error(`${I(t.info)} is not editable`);let n=String(f.text),o=t.el;if(o.tagName==="SELECT"){let d=Array.from(o.options),u=d.find(h=>String(h.value)===n)||d.find(h=>T(h.label||h.textContent)===n);if(!u)throw new Error(`${JSON.stringify(n)} is not an option of ${I(t.info)}. Options: ${d.map(h=>`${JSON.stringify(String(h.value))} (${JSON.stringify(T(h.label||h.textContent))})`).join(", ")}`);n=String(u.value)}let r=o.tagName==="INPUT"&&String(o.type||"").toLowerCase()==="password";if(typeof o.focus=="function"&&o.focus(),z(o,n),o.tagName==="SELECT"?o.dispatchEvent(new s.Event("input",{bubbles:!0})):o.dispatchEvent(new s.InputEvent("input",{bubbles:!0,inputType:"insertText",data:n})),o.dispatchEvent(new s.Event("change",{bubbles:!0})),e.submit){let d={key:"Enter",code:"Enter",bubbles:!0,cancelable:!0},u=new s.KeyboardEvent("keydown",d);o.dispatchEvent(u),o.dispatchEvent(new s.KeyboardEvent("keyup",d)),!u.defaultPrevented&&o.form&&typeof o.form.requestSubmit=="function"&&o.form.requestSubmit()}let a=await j(),g=O().find(d=>d.el===o);return{filled:r?"[redacted]":n,element:(g||t).info,settled:a}}if(f.op==="waitFor"){let t=e.timeoutMs??5e3,n=Date.now();for(;q(O(),f.target).length>0===!!e.gone;){if(Date.now()-n>=t){let i=O();throw new Error(e.gone?`${C(f.target)} is still on the page after ${t} ms. On the page: ${U(i)}`:`Timed out after ${t} ms waiting for ${C(f.target)}. On the page: ${U(i)}`)}await G(50)}let o=await j();return{found:!e.gone,waitedMs:Date.now()-n,settled:o}}throw new Error(`Unknown operation ${String(f.op)}`)};try{Z().then(e=>k(!0,e),$)}catch(e){$(e)}}return ie(ce);})();;return __agentBridgePage})()';
+
+// src/adapters/webview-host.ts
+var LOG_CAPACITY = 100;
+var BODY_CHARS = 2048;
+var CALL_TIMEOUT_MS = 1e4;
+var registry = /* @__PURE__ */ new Map();
+var nextId = 1;
+var entries = () => [...registry.values()];
+function entryNamed(name) {
+  if (name === void 0) {
+    if (registry.size === 1) return registry.values().next().value;
+    if (!registry.size) throw new Error("No WebView is registered (useWebViewTools)");
+    throw new Error(
+      `Several WebViews are registered; say which: ${[...registry.keys()].join(", ")}`
+    );
+  }
+  const entry = registry.get(name);
+  if (!entry)
+    throw new Error(
+      `Unknown WebView "${name}". Registered: ${[...registry.keys()].join(", ") || "none"}`
+    );
+  return entry;
+}
+var DEFAULT_PORTS = { "http:": "80", "https:": "443", "ws:": "80", "wss:": "443" };
+function originOf(value) {
+  const found = /^([a-z][a-z0-9+.-]*:)\/\/([^/?#]*)/i.exec(value.trim());
+  if (!found) return "null";
+  const scheme = found[1].toLowerCase();
+  if (!(scheme in DEFAULT_PORTS)) return "null";
+  const authority = found[2].slice(found[2].lastIndexOf("@") + 1).toLowerCase();
+  const port = /:(\d*)$/.exec(authority);
+  const host = port ? authority.slice(0, -port[0].length) : authority;
+  if (!host) return "null";
+  const keep = port?.[1] && port[1] !== DEFAULT_PORTS[scheme] ? `:${port[1]}` : "";
+  return `${scheme}//${host}${keep}`;
+}
+var allowedOrigins = (entry) => {
+  const explicit = (entry.options.allowedOrigins ?? []).map(
+    (o) => o.trim().toLowerCase() === "null" ? "null" : originOf(o)
+  );
+  const initial = entry.initialOrigin && entry.initialOrigin !== "null" ? [entry.initialOrigin] : [];
+  return [.../* @__PURE__ */ new Set([...initial, ...explicit])];
+};
+var isAllowed = (entry, origin) => origin !== void 0 && allowedOrigins(entry).includes(origin);
+var REDACTED = "[redacted]";
+function redactValue(redact, name, value, path, seen = []) {
+  if (typeof value === "function") return value;
+  if (typeof redact === "function") {
+    if (path) value = redact(name, path, value);
+  } else if (path && redact.some((p) => path === p || path.startsWith(`${p}.`))) {
+    return REDACTED;
+  }
+  if (typeof value !== "object" || value === null || seen.includes(value)) return value;
+  const next = [...seen, value];
+  const items = Object.entries(value).map(
+    ([k, v]) => [k, redactValue(redact, name, v, path ? `${path}.${k}` : k, next)]
+  );
+  return Array.isArray(value) ? items.map(([, v]) => v) : Object.fromEntries(items);
+}
+function redactBody(entry, body) {
+  const { redact, name } = entry.options;
+  if (!redact) return body;
+  let parsed;
+  try {
+    parsed = JSON.parse(body);
+  } catch {
+    if (typeof redact !== "function") return body;
+    const out = redact(name, "", body);
+    return typeof out === "string" ? out : JSON.stringify(out);
+  }
+  if (typeof parsed !== "object" || parsed === null) {
+    if (typeof redact !== "function") return body;
+    const out = redact(name, "", parsed);
+    return typeof out === "string" ? out : JSON.stringify(out);
+  }
+  return JSON.stringify(redactValue(redact, name, parsed, ""));
+}
+function record(entry, direction, via, body) {
+  const text = typeof body === "string" ? body : safeStringify(body);
+  entry.log.push({
+    id: nextId++,
+    at: Date.now(),
+    webview: entry.options.name,
+    direction,
+    via,
+    body: redactBody(entry, text)
+  });
+  if (entry.log.length > LOG_CAPACITY) entry.log.shift();
+}
+var safeStringify = (value) => {
+  try {
+    return JSON.stringify(value) ?? String(value);
+  } catch {
+    return String(value);
+  }
+};
+function shown(message) {
+  const { body, ...rest } = message;
+  if (body.length <= BODY_CHARS) return { ...rest, body };
+  return { ...rest, body: body.slice(0, BODY_CHARS), truncated: true, size: body.length };
+}
+function messageById(id) {
+  for (const entry of registry.values()) {
+    const found = entry.log.find((m) => m.id === id);
+    if (found) return found;
+  }
+  throw new Error(`No message ${id} in the log (it keeps the last ${LOG_CAPACITY} per WebView)`);
+}
+var randomNonce = () => {
+  const c = globalThis.crypto;
+  const bytes = new Uint8Array(16);
+  if (c?.getRandomValues) c.getRandomValues(bytes);
+  else for (let i = 0; i < bytes.length; i++) bytes[i] = Math.floor(Math.random() * 256);
+  return Array.from(bytes, (b) => b.toString(16).padStart(2, "0")).join("");
+};
+var bootScript = (token) => `(function(){var rn=window.ReactNativeWebView,p=rn&&rn.postMessage&&rn.postMessage.bind(rn);${PAGE_BUNDLE}.bootMain(window,function(s){(p||window.ReactNativeWebView.postMessage.bind(window.ReactNativeWebView))(s)},${JSON.stringify(token)})})();true;`;
+var literal = (value) => JSON.stringify(value).replace(/\u2028/g, "\\u2028").replace(/\u2029/g, "\\u2029");
+var callScript = (argsJson) => `${PAGE_BUNDLE}.pageMain(window,${literal(argsJson)},function(s){window.ReactNativeWebView.postMessage(s)});true;`;
+function attach(entry) {
+  const instance = entry.ref.current;
+  if (entry.patched && entry.patched.instance === instance) return;
+  entry.patched?.undo();
+  entry.patched = null;
+  if (!instance) return;
+  const { postMessage, injectJavaScript } = instance;
+  const inject = injectJavaScript.bind(instance);
+  const post = postMessage.bind(instance);
+  instance.postMessage = (data) => {
+    record(entry, "app\u2192page", "postMessage", data);
+    return post(data);
+  };
+  instance.injectJavaScript = (script) => {
+    record(entry, "app\u2192page", "injectJavaScript", script);
+    return inject(script);
+  };
+  entry.patched = {
+    instance,
+    undo: () => {
+      instance.postMessage = postMessage;
+      instance.injectJavaScript = injectJavaScript;
+    }
+  };
+  originals.set(entry, { inject, post });
+}
+var originals = /* @__PURE__ */ new WeakMap();
+var timing = { handshakeMs: void 0 };
+var DEFAULT_LOAD_WAIT_MS = 1e4;
+var PAGE_LOG_CHARS = 500;
+var asRecord = (value) => {
+  if (typeof value !== "string" || !value.startsWith("{") || !value.includes("__agentBridge")) return null;
+  try {
+    const parsed = JSON.parse(value);
+    return parsed && parsed.__agentBridge === 1 ? parsed : null;
+  } catch {
+    return null;
+  }
+};
+function navigated(entry, url) {
+  entry.handshake = false;
+  entry.nativeLoaded = false;
+  entry.loaded = false;
+  if (url !== void 0) {
+    entry.url = url;
+    entry.origin = originOf(url);
+    entry.initialOrigin ?? (entry.initialOrigin = entry.origin);
+  }
+  for (const [nonce, pending] of [...entry.pending]) {
+    entry.pending.delete(nonce);
+    clearTimeout(pending.timer);
+    if (pending.op === "press" || pending.op === "fill")
+      pending.resolve({ navigated: true, url: entry.url ?? null });
+    else
+      pending.reject(
+        new Error(
+          `The page navigated to ${entry.url ?? "another page"} during webview.${pending.op}; call it again on the new page`
+        )
+      );
+  }
+}
+function rotateToken(entry) {
+  entry.token = randomNonce();
+  entry.onRotate?.();
+}
+function seeNative(entry, event, kind) {
+  const info = event?.nativeEvent;
+  if (info?.isTopFrame === false || typeof info?.url !== "string") return false;
+  const origin = originOf(info.url);
+  entry.initialOrigin ?? (entry.initialOrigin = origin);
+  const orphan = kind === "start" && entry.orphanLoading === info.url;
+  if (kind === "start") entry.orphanLoading = void 0;
+  if (orphan) {
+    entry.url = info.url;
+    entry.origin = origin;
+  } else if (kind === "start" || origin !== entry.origin) {
+    navigated(entry, info.url);
+    if (kind === "start") entry.startPending = true;
+  }
+  if (!isAllowed(entry, origin) && kind !== "message") rotateToken(entry);
+  else entry.url = info.url;
+  if (kind === "end") {
+    entry.nativeLoaded = true;
+    entry.loaded = true;
+    for (const listener of [...entry.onLoaded]) listener();
+  }
+  return true;
+}
+function onOwnMessage(entry, message, event) {
+  if (message.t !== entry.token) return;
+  if (!seeNative(entry, event, "message")) return;
+  if (!isAllowed(entry, entry.origin)) return;
+  const url = event.nativeEvent?.url;
+  if (message.kind === "state") {
+    if (message.state === "loading") {
+      const started = entry.startPending;
+      entry.startPending = false;
+      navigated(entry, url);
+      entry.orphanLoading = started ? void 0 : url;
+    }
+    if (message.state === "loaded") {
+      entry.loaded = true;
+      for (const listener of [...entry.onLoaded]) listener();
+    }
+    entry.handshake = true;
+    for (const listener of [...entry.onHandshake]) listener();
+  } else if (message.kind === "log") {
+    const text = String(message.message).replace(/\s*[\r\n]+\s*/g, " \u23CE ").slice(0, PAGE_LOG_CHARS);
+    logToBridge("error", `[webview ${entry.options.name}, page output] ${text}`);
+  } else if (message.kind === "reply" && typeof message.nonce === "string") {
+    const pending = entry.pending.get(message.nonce);
+    if (!pending) return;
+    entry.pending.delete(message.nonce);
+    clearTimeout(pending.timer);
+    if (message.ok === true) pending.resolve(message.result);
+    else pending.reject(new Error(String(message.error)));
+  }
+}
+function register(ref, options) {
+  const entry = {
+    options,
+    ref,
+    url: void 0,
+    origin: void 0,
+    initialOrigin: void 0,
+    loaded: false,
+    handshake: false,
+    nativeLoaded: false,
+    warnedDuplicate: false,
+    orphanLoading: void 0,
+    startPending: false,
+    token: randomNonce(),
+    onRotate: void 0,
+    onHandshake: /* @__PURE__ */ new Set(),
+    log: [],
+    pending: /* @__PURE__ */ new Map(),
+    handler: void 0,
+    patched: null,
+    onLoaded: /* @__PURE__ */ new Set()
+  };
+  const wrap = (onMessage) => {
+    entry.handler = onMessage;
+    return (event) => {
+      const data = event?.nativeEvent?.data;
+      const own = asRecord(data);
+      if (own) return onOwnMessage(entry, own, event);
+      record(entry, "page\u2192app", "onMessage", typeof data === "string" ? data : safeStringify(data));
+      return entry.handler?.(event);
+    };
+  };
+  const props = () => ({
+    injectedJavaScriptBeforeContentLoaded: `${webViewMark(entry.options.name)}${bootScript(entry.token)}${entry.options.injectedJavaScriptBeforeContentLoaded ?? ""}`,
+    // Forced: in a sub-frame the script's token would be in reach of a page that isn't the app's.
+    injectedJavaScriptBeforeContentLoadedForMainFrameOnly: true,
+    onLoadStart: (event) => {
+      seeNative(entry, event, "start");
+      entry.options.onLoadStart?.(event);
+    },
+    onLoadEnd: (event) => {
+      seeNative(entry, event, "end");
+      entry.options.onLoadEnd?.(event);
+    },
+    onNavigationStateChange: (state) => {
+      seeNative(entry, { nativeEvent: state }, "nav");
+      entry.options.onNavigationStateChange?.(state);
+    }
+  });
+  return {
+    entry,
+    wrap,
+    props,
+    mount: () => {
+      const name = entry.options.name;
+      const existing = registry.get(name);
+      if (existing && existing !== entry) {
+        if (!entry.warnedDuplicate) {
+          entry.warnedDuplicate = true;
+          console.error(
+            `agent-bridge: a WebView named "${name}" is already registered; this one is not reachable. Give each WebView its own name.`
+          );
+        }
+        return;
+      }
+      entry.warnedDuplicate = false;
+      registry.set(name, entry);
+      attach(entry);
+    },
+    dispose: () => {
+      entry.patched?.undo();
+      entry.patched = null;
+      dropPending(entry, "The WebView was unmounted");
+      if (registry.get(entry.options.name) === entry) registry.delete(entry.options.name);
+    }
+  };
+}
+function dropPending(entry, why) {
+  for (const [nonce, pending] of entry.pending) {
+    clearTimeout(pending.timer);
+    pending.reject(new Error(why));
+    entry.pending.delete(nonce);
+  }
+}
+var notAllowed = (entry) => new Error(
+  `WebView "${entry.options.name}" is on ${entry.origin ?? "an unknown origin"}, which is not allowed (allowed: ${allowedOrigins(entry).join(", ") || "none"}). Add it to allowedOrigins to read or drive it`
+);
+var handshakeError = (entry) => new Error(
+  entry.nativeLoaded ? `WebView "${entry.options.name}" loaded but its page script did not check in. Spread useWebViewTools' props and pass wrap(onMessage) as onMessage; if you set your own injectedJavaScriptBeforeContentLoaded, pass it through useWebViewTools options instead` : `WebView "${entry.options.name}" is still loading`
+);
+function refusal(entry) {
+  if (entry.origin === void 0)
+    return new Error(`WebView "${entry.options.name}" has not loaded a page yet`);
+  if (!isAllowed(entry, entry.origin)) return notAllowed(entry);
+  return null;
+}
+function requireVerified(entry) {
+  const why = refusal(entry) ?? (entry.handshake ? null : handshakeError(entry));
+  if (why) throw why;
+}
+var isCurrentAllowed = (entry) => entry.origin === void 0 ? void 0 : isAllowed(entry, entry.origin);
+function awaitHandshake(entry) {
+  return new Promise((resolve, reject) => {
+    const settleNow = () => {
+      const why = entry.origin === void 0 ? null : refusal(entry);
+      if (why) return done(why);
+      if (entry.handshake) return done();
+    };
+    const timer = setTimeout(() => done(refusal(entry) ?? handshakeError(entry)), timing.handshakeMs ?? entry.options.firstLoadTimeoutMs ?? DEFAULT_LOAD_WAIT_MS);
+    const done = (error) => {
+      clearTimeout(timer);
+      entry.onHandshake.delete(settleNow);
+      if (error) reject(error);
+      else resolve();
+    };
+    entry.onHandshake.add(settleNow);
+    settleNow();
+  });
+}
+async function callPage(entry, op, args, timeoutMs = CALL_TIMEOUT_MS) {
+  const { name } = entry.options;
+  if (!entry.ref.current) throw new Error(`WebView "${name}" is not mounted`);
+  attach(entry);
+  await awaitHandshake(entry);
+  const webview = entry.ref.current;
+  if (!webview) throw new Error(`WebView "${name}" is not mounted`);
+  requireVerified(entry);
+  const allowed = allowedOrigins(entry);
+  const nonce = randomNonce();
+  const script = callScript(JSON.stringify({ ...args, op, nonce, allowed, token: entry.token }));
+  return new Promise((resolve, reject) => {
+    const timer = setTimeout(() => {
+      entry.pending.delete(nonce);
+      reject(
+        new Error(
+          `No reply from WebView "${name}" in ${Math.round(timeoutMs / 1e3)} s. Is a page loaded${entry.loaded ? "" : " (it is still loading)"}?`
+        )
+      );
+    }, timeoutMs);
+    entry.pending.set(nonce, { op, resolve, reject, timer });
+    try {
+      ;
+      (originals.get(entry)?.inject ?? webview.injectJavaScript.bind(webview))(script);
+    } catch (error) {
+      entry.pending.delete(nonce);
+      clearTimeout(timer);
+      reject(error instanceof Error ? error : new Error(String(error)));
+    }
+  });
+}
+function sendToPage(entry, body) {
+  const webview = entry.ref.current;
+  if (!webview) throw new Error(`WebView "${entry.options.name}" is not mounted`);
+  attach(entry);
+  requireVerified(entry);
+  (originals.get(entry)?.post ?? webview.postMessage.bind(webview))(body);
+  record(entry, "app\u2192page", "webview.send", body);
+}
+function restoreAll() {
+  let cleared = 0;
+  for (const entry of registry.values()) {
+    cleared += entry.log.length;
+    entry.log = [];
+    dropPending(entry, "Cleared by webview.restore");
+  }
+  return { cleared };
+}
+
+// src/adapters/react-native-webview.ts
+function useWebViewTools(ref, options) {
+  const host = (0, import_react.useMemo)(() => register(ref, options), [ref, options.name]);
+  host.entry.options = options;
+  const [version, setVersion] = (0, import_react.useState)(0);
+  host.entry.onRotate = () => setVersion((v) => v + 1);
+  (0, import_react.useEffect)(() => {
+    host.mount();
+    return host.dispose;
+  }, [host]);
+  (0, import_react.useEffect)(() => host.mount());
+  const props = (0, import_react.useMemo)(
+    () => host.props(),
+    [host, version, options.injectedJavaScriptBeforeContentLoaded]
+  );
+  return { props, wrap: host.wrap };
+}
+function nameAndData(args, tool) {
+  if (args.length === 0 || args.length > 2)
+    throw new Error(`${tool} takes [name] <json>`);
+  return args.length === 2 ? [entryNamed(String(args[0])), args[1]] : [entryNamed(), args[0]];
+}
+var bodyOf = (data) => typeof data === "string" ? data : JSON.stringify(data);
+var TARGET_HELP = "target is a string (testID, label, placeholder, text, then role) or an object that must match every key it sets: {testID, label, placeholder, text, role, index}. testID is data-testid, data-test-id or data-cy. Several matches: add an index, in the target or as {index:n}.";
+var WHICH = "Give {webview: name} as the last argument when more than one WebView is registered.";
+function webviewTools() {
+  return {
+    "webview.list": {
+      maxArgs: 0,
+      description: "The registered WebViews: name, current url, whether the page has loaded, whether its origin is allowed (a page outside the allowed origins is never read or driven), and the allowed origins.",
+      run: () => entries().map((entry) => ({
+        name: entry.options.name,
+        mounted: !!entry.ref.current,
+        url: entry.url ?? null,
+        loaded: entry.loaded,
+        ready: entry.handshake,
+        allowed: isCurrentAllowed(entry) ?? null,
+        origins: allowedOrigins(entry)
+      }))
+    },
+    "webview.snapshot": {
+      maxArgs: 1,
+      description: 'Buttons, links, inputs, text and testID/aria-label elements in a WebView page, in the same shape as screen.snapshot (kind, text, testID, label, placeholder, value, role, checked, disabled, rect). Pierces open shadow roots and same-origin iframes; a cross-origin iframe shows as "iframe (cross-origin, not reachable)". Arguments: [name].',
+      run: (name) => callPage(entryNamed(name), "snapshot", {})
+    },
+    "webview.press": {
+      maxArgs: 2,
+      description: `Click a button, link or control in a WebView page, then wait for the page to settle (next frame, then 100 ms without DOM changes, at most 2 s). Not undone by webview.restore. ${TARGET_HELP} Disabled elements are refused; {force:true} presses anyway. ${WHICH}`,
+      run: (target, options = {}) => callPage(entryNamed(options.webview), "press", {
+        target,
+        options: { force: options.force, index: options.index }
+      })
+    },
+    "webview.fill": {
+      maxArgs: 3,
+      description: `Set an input's value in a WebView page through the native value setter and dispatch input and change events, so React and Vue inputs pick it up, then wait for the page to settle. Not undone by webview.restore. ${TARGET_HELP} {submit:true} also presses Enter. ${WHICH}`,
+      run: (target, text, options = {}) => callPage(entryNamed(options.webview), "fill", {
+        target,
+        text,
+        options: { submit: options.submit, index: options.index }
+      })
+    },
+    "webview.waitFor": {
+      maxArgs: 2,
+      description: `Wait until a target is on the WebView page, or gone with {gone:true}, then wait for the page to settle. Default timeout 5000 ms; a timeout lists what is on the page. ${TARGET_HELP} ${WHICH}`,
+      run: (target, options = {}) => callPage(
+        entryNamed(options.webview),
+        "waitFor",
+        { target, options: { gone: options.gone, timeoutMs: options.timeoutMs } },
+        (options.timeoutMs ?? 5e3) + 5e3
+      )
+    },
+    "webview.url": {
+      maxArgs: 1,
+      description: "The URL a WebView is on, as it last reported it. Arguments: [name].",
+      run: (name) => {
+        const entry = entryNamed(name);
+        return { url: entry.url ?? null, allowed: isCurrentAllowed(entry) ?? null };
+      }
+    },
+    "webview.reload": {
+      maxArgs: 1,
+      description: "Reload the page, and wait up to 10 s for it to load again. Arguments: [name].",
+      run: async (name) => {
+        const entry = entryNamed(name);
+        const webview = entry.ref.current;
+        if (!webview) throw new Error(`WebView "${entry.options.name}" is not mounted`);
+        const loaded = new Promise((resolve) => {
+          const done = () => {
+            clearTimeout(timer);
+            entry.onLoaded.delete(done);
+            resolve(true);
+          };
+          const timer = setTimeout(() => {
+            entry.onLoaded.delete(done);
+            resolve(false);
+          }, 1e4);
+          entry.onLoaded.add(done);
+        });
+        entry.loaded = false;
+        webview.reload();
+        return { reloaded: true, loaded: await loaded, url: entry.url ?? null };
+      }
+    },
+    "webview.messages": {
+      maxArgs: 2,
+      description: `The last 100 messages in both directions, oldest first, with timestamps: page \u2192 app (onMessage) and app \u2192 page (postMessage, injectJavaScript, and what webview.send delivered). Bodies are cut at ${BODY_CHARS / 1024} KB (truncated:true, size); webview.message <id> returns one in full. Bodies are redacted by the WebView's redact option. Arguments: [name], {limit}. Without a name, every WebView's, merged by time.`,
+      run: (first, second) => {
+        const name = typeof first === "string" ? first : void 0;
+        const options = (typeof first === "string" ? second : first) ?? {};
+        const all = (name === void 0 ? entries() : [entryNamed(name)]).flatMap((entry) => entry.log).sort((a, b) => a.id - b.id);
+        return (options.limit !== void 0 ? all.slice(-options.limit) : all).map(shown);
+      }
+    },
+    "webview.message": {
+      maxArgs: 1,
+      description: "One logged message in full, by the id webview.messages shows (redacted like the log).",
+      run: (id) => messageById(Number(id))
+    },
+    "webview.send": {
+      maxArgs: 2,
+      description: "Deliver a message to the page as if the app had sent it (WebView postMessage): a string as is, anything else as JSON. Arguments: [name] <json>. Refused when the page is outside the allowed origins. It is logged, and not undone.",
+      run: async (...args) => {
+        const [entry, data] = nameAndData(args, "webview.send");
+        sendToPage(entry, bodyOf(data));
+        return { sent: true };
+      }
+    },
+    "webview.receive": {
+      maxArgs: 2,
+      description: "Run the app's onMessage handler with a fake page message, without the page sending it: a string as is, anything else as JSON. Arguments: [name] <json>. Then waits for the render. Errors from the handler come back as errors. Not undone: mock what the handler does with onRestore.",
+      run: async (...args) => {
+        const [entry, data] = nameAndData(args, "webview.receive");
+        if (!entry.handler)
+          throw new Error(
+            `WebView "${entry.options.name}" has no onMessage handler: pass wrap(onMessage) to the WebView`
+          );
+        requireVerified(entry);
+        const body = bodyOf(data);
+        record(entry, "page\u2192app", "webview.receive", body);
+        const result = await entry.handler({
+          nativeEvent: {
+            data: body,
+            url: entry.url ?? "",
+            title: "",
+            loading: false,
+            canGoBack: false,
+            canGoForward: false,
+            lockIdentifier: 0,
+            target: 0
+          }
+        });
+        await settle();
+        return { delivered: true, ...result === void 0 ? {} : { result } };
+      }
+    },
+    "webview.restore": {
+      maxArgs: 0,
+      description: "Clear the message logs and drop any call still waiting for a reply. webview.press, fill and send change the page and the app and are not undone: reload the page, or mock host handlers with onRestore.",
+      run: () => restoreAll()
+    }
+  };
+}