@avasapp/agent-bridge 0.4.2 → 0.5.0

package/dist/client/index.cjs

@@ -76,11 +76,11 @@ async function listCdpTargets(metro, signal) {
     );
   return await res.json();
 }
-function pickOne(items, filter, label) {
+function pickOne(items, filter, label2) {
   const matching = filter ? items.filter(
-    (item) => label(item).toLowerCase().includes(filter.toLowerCase())
+    (item) => label2(item).toLowerCase().includes(filter.toLowerCase())
   ) : items;
-  const connected = items.map(label).join("; ") || "none";
+  const connected = items.map(label2).join("; ") || "none";
   if (matching.length === 0) {
     throw new Error(
       filter ? `No app matches "${filter}". Connected: ${connected}` : "No app is connected to Metro."
@@ -93,11 +93,11 @@ function pickOne(items, filter, label) {
   }
   if (matching.length > 1) {
     const exact = matching.filter(
-      (item) => label(item).toLowerCase() === filter?.toLowerCase()
+      (item) => label2(item).toLowerCase() === filter?.toLowerCase()
     );
     if (exact.length === 1) return exact[0];
     throw new Error(
-      `${matching.length} apps match "${filter}"; narrow --device. Matching: ${matching.map(label).join("; ")}`
+      `${matching.length} apps match "${filter}"; narrow --device. Matching: ${matching.map(label2).join("; ")}`
     );
   }
   return matching[0];
@@ -295,6 +295,206 @@ async function connectExpo(metro, device, discoveryMs = 600, signal, pin) {
   };
 }
 
+// src/client/session/state.ts
+var import_node_crypto = require("crypto");
+var import_node_fs = require("fs");
+var import_node_os = require("os");
+var import_node_path = require("path");
+function projectRoot(from = process.cwd()) {
+  for (let dir = (0, import_node_path.resolve)(from); ; dir = (0, import_node_path.dirname)(dir)) {
+    if ((0, import_node_fs.existsSync)((0, import_node_path.join)(dir, "package.json"))) return dir;
+    if ((0, import_node_path.dirname)(dir) === dir) return (0, import_node_path.resolve)(from);
+  }
+}
+var uid = () => process.getuid?.() ?? (0, import_node_os.userInfo)().username;
+function privateDir(dir) {
+  (0, import_node_fs.mkdirSync)(dir, { recursive: true, mode: 448 });
+  const stat = (0, import_node_fs.lstatSync)(dir);
+  if (!stat.isDirectory())
+    throw new Error(`${dir} is not a directory; remove it and retry`);
+  if (process.getuid && stat.uid !== process.getuid())
+    throw new Error(`${dir} belongs to another user; refusing to use it`);
+  if (process.platform !== "win32" && (stat.mode & 63) !== 0)
+    (0, import_node_fs.chmodSync)(dir, 448);
+  return dir;
+}
+function stateDir() {
+  return privateDir(
+    process.env.AGENT_BRIDGE_STATE_DIR ?? (process.env.XDG_RUNTIME_DIR ? (0, import_node_path.join)(process.env.XDG_RUNTIME_DIR, "agent-bridge") : (0, import_node_path.join)((0, import_node_os.tmpdir)(), `agent-bridge-${uid()}`))
+  );
+}
+var shortHash = (text) => (0, import_node_crypto.createHash)("sha256").update(text).digest("hex").slice(0, 16);
+function socketPath(name, dir) {
+  if (process.platform === "win32")
+    return `\\\\.\\pipe\\agent-bridge-${shortHash(dir)}-${name}`;
+  const path = (0, import_node_path.join)(dir, `${name}.sock`);
+  if (Buffer.byteLength(path) <= 100) return path;
+  const short = privateDir(`/tmp/agent-bridge-${uid()}`);
+  return (0, import_node_path.join)(short, `${shortHash(path)}.sock`);
+}
+var sessionFiles = (name, dir = stateDir()) => ({
+  state: (0, import_node_path.join)(dir, `${name}.json`),
+  error: (0, import_node_path.join)(dir, `${name}.error`),
+  log: (0, import_node_path.join)(dir, `${name}.log`),
+  socket: socketPath(name, dir)
+});
+function checkName(name) {
+  if (!/^[\w.-]{1,40}$/.test(name))
+    throw new Error(
+      `Session name "${name}" must be 1-40 letters, digits, ".", "_" or "-"`
+    );
+  return name;
+}
+function isAlive(pid) {
+  try {
+    process.kill(pid, 0);
+    return true;
+  } catch (error) {
+    return error.code === "EPERM";
+  }
+}
+function removeSessionFiles(name, dir = stateDir()) {
+  const files = sessionFiles(name, dir);
+  (0, import_node_fs.rmSync)(files.state, { force: true });
+  if (process.platform !== "win32") (0, import_node_fs.rmSync)(files.socket, { force: true });
+}
+function readState(file) {
+  try {
+    return JSON.parse((0, import_node_fs.readFileSync)(file, "utf8"));
+  } catch {
+    return null;
+  }
+}
+function listSessions(dir = stateDir()) {
+  const live = [];
+  for (const entry of (0, import_node_fs.readdirSync)(dir)) {
+    if (!entry.endsWith(".json")) continue;
+    const state = readState((0, import_node_path.join)(dir, entry));
+    if (!state) continue;
+    if (isAlive(state.pid)) live.push(state);
+    else removeSessionFiles(state.name, dir);
+  }
+  return live.sort((a, b) => a.startedAt - b.startedAt);
+}
+function readSession(name, dir = stateDir()) {
+  return listSessions(dir).find((s) => s.name === name) ?? null;
+}
+function pickSession(filter) {
+  if (filter.name) {
+    const named = readSession(checkName(filter.name));
+    if (!named) throw new Error(`No session named "${filter.name}" is running`);
+    return named;
+  }
+  const device = filter.device?.toLowerCase();
+  const explicit = !!(filter.metro || device || filter.transport && filter.transport !== "auto");
+  const project = projectRoot();
+  const matching = listSessions().filter(
+    (s) => (explicit || s.project === project) && (!filter.metro || s.metro === filter.metro) && (!device || s.device.name.toLowerCase().includes(device) || s.device.deviceId.toLowerCase().includes(device)) && (!filter.transport || filter.transport === "auto" || filter.transport === s.transport)
+  );
+  if (matching.length > 1)
+    throw new Error(
+      `Several sessions match (${matching.map((s) => `${s.name}: ${s.device.name} on ${s.metro}`).join("; ")}); pick one by name (--session, or --name for session stop/status), or narrow with --metro/--device`
+    );
+  return matching[0] ?? null;
+}
+
+// src/client/metro-hint.ts
+var range = (from, to) => Array.from({ length: to - from + 1 }, (_, i) => from + i);
+var probe = {
+  ports: [...range(8081, 8090), ...range(8100, 8199)],
+  eachMs: 300,
+  totalMs: 1e3
+};
+var hostOf = (metro) => {
+  const colon = metro.lastIndexOf(":");
+  return colon > 0 && !metro.endsWith("]") ? metro.slice(0, colon) : metro;
+};
+async function answers(metro, signal) {
+  try {
+    const res = await fetch(`http://${metro}/status`, { signal });
+    return (await res.text()).includes("packager-status:running");
+  } catch {
+    return false;
+  }
+}
+async function appsOn(metro, signal) {
+  try {
+    const res = await fetch(`http://${metro}/json/list`, { signal });
+    const targets = await res.json();
+    const names = targets.map(
+      (t) => `${t.title ?? "?"}${t.deviceName ? ` [${t.deviceName}]` : ""}`
+    );
+    return [...new Set(names)];
+  } catch {
+    return [];
+  }
+}
+async function findMetros(metro) {
+  const host = hostOf(metro);
+  const candidates = new Set(probe.ports.map((port) => `${host}:${port}`));
+  try {
+    for (const s of listSessions()) candidates.add(s.metro);
+  } catch {
+  }
+  candidates.delete(metro);
+  const deadline = AbortSignal.timeout(probe.totalMs);
+  const within2 = () => AbortSignal.any([deadline, AbortSignal.timeout(probe.eachMs)]);
+  const running = (await Promise.all(
+    [...candidates].map(async (m) => await answers(m, within2()) ? m : null)
+  )).filter((m) => m !== null);
+  return Promise.all(
+    running.map(async (m) => ({ metro: m, apps: await appsOn(m, within2()) }))
+  );
+}
+var label = (found) => `${found.metro} (${found.apps.length ? `${found.apps.length === 1 ? "app" : "apps"}: ${found.apps.join(", ")}` : "no app connected"})`;
+var howToSet = (metro) => `Pass --metro ${metro} or set AGENT_BRIDGE_METRO=${metro}.`;
+function elsewhere(found) {
+  const [only] = found;
+  if (found.length === 1 && only)
+    return `Metro is running on ${label(only)}. ${howToSet(only.metro)}`;
+  return `Metro is running on ${found.map(label).join("; ")}. ${howToSet("<host:port>")}`;
+}
+var errorText = (error) => {
+  if (!(error instanceof Error)) return String(error);
+  const code = error.code ?? "";
+  return `${error.message} ${code} ${error.cause ? errorText(error.cause) : ""}`;
+};
+var isRefused = (error) => /ECONNREFUSED|ConnectionRefused/.test(errorText(error));
+var NO_APP = /No app is connected to Metro|No app matches/;
+async function refusedMessage(metro) {
+  const found = await findMetros(metro);
+  if (found.length)
+    return `Nothing is listening on ${metro}. ${elsewhere(found)}`;
+  const host = hostOf(metro);
+  return `Nothing is listening on ${metro}, and no Metro answered on ${host} ports 8081-8090 or 8100-8199. Start Metro, or if it runs elsewhere, pass --metro <host:port> or set AGENT_BRIDGE_METRO=<host:port>.`;
+}
+async function noAppHint(metro, device) {
+  const causes = `Likely: the app isn't open or hasn't reloaded since the bridge was mounted, it uses another Metro${device ? `, or --device "${device}" doesn't match` : ""}.`;
+  const withApps = (await findMetros(metro)).filter((f) => f.apps.length);
+  return withApps.length ? `${causes} ${elsewhere(withApps)}` : causes;
+}
+async function refused(metro) {
+  try {
+    await fetch(`http://${metro}/status`, {
+      signal: AbortSignal.timeout(probe.eachMs)
+    });
+    return false;
+  } catch (error) {
+    return isRefused(error);
+  }
+}
+async function explainConnectError(error, metro, device) {
+  const message = error instanceof Error ? error.message : String(error);
+  if (NO_APP.test(message))
+    return new Error(`${message}
+${await noAppHint(metro, device)}`, {
+      cause: error
+    });
+  if (await refused(metro))
+    return new Error(await refusedMessage(metro), { cause: error });
+  return error;
+}
+
 // src/client/cdp.ts
 var import_ws2 = __toESM(require("ws"), 1);
 var CannotEvaluate = class extends Error {
@@ -529,7 +729,7 @@ async function runFlow(bridge, flow, options = {}) {
     }
   };
   const call = async (tool, ...args) => (await timed(tool, ...args)).value;
-  const step = async (label, tool, ...given) => {
+  const step = async (label2, tool, ...given) => {
     const args = given.length === 1 && Array.isArray(given[0]) ? given[0] : given;
     const { value, ms, logs, notice } = await bridge.timed(tool, ...args).catch((error) => {
       report(failedLogs(error), failedNotice(error));
@@ -537,7 +737,7 @@ async function runFlow(bridge, flow, options = {}) {
     });
     total += ms;
     print(
-      `${String(++n).padStart(2, "0")} ${label.padEnd(30)} ${ms.toFixed(1).padStart(7)} ms`
+      `${String(++n).padStart(2, "0")} ${label2.padEnd(30)} ${ms.toFixed(1).padStart(7)} ms`
     );
     report(logs, notice);
     return value;
@@ -589,109 +789,6 @@ var import_node_readline = require("readline");
 var encodeLine = (message) => `${JSON.stringify(message).replace(/[\u2028\u2029]/g, (c) => `\\u${c.charCodeAt(0).toString(16)}`)}
 `;
 
-// src/client/session/state.ts
-var import_node_crypto = require("crypto");
-var import_node_fs = require("fs");
-var import_node_os = require("os");
-var import_node_path = require("path");
-function projectRoot(from = process.cwd()) {
-  for (let dir = (0, import_node_path.resolve)(from); ; dir = (0, import_node_path.dirname)(dir)) {
-    if ((0, import_node_fs.existsSync)((0, import_node_path.join)(dir, "package.json"))) return dir;
-    if ((0, import_node_path.dirname)(dir) === dir) return (0, import_node_path.resolve)(from);
-  }
-}
-var uid = () => process.getuid?.() ?? (0, import_node_os.userInfo)().username;
-function privateDir(dir) {
-  (0, import_node_fs.mkdirSync)(dir, { recursive: true, mode: 448 });
-  const stat = (0, import_node_fs.lstatSync)(dir);
-  if (!stat.isDirectory())
-    throw new Error(`${dir} is not a directory; remove it and retry`);
-  if (process.getuid && stat.uid !== process.getuid())
-    throw new Error(`${dir} belongs to another user; refusing to use it`);
-  if (process.platform !== "win32" && (stat.mode & 63) !== 0)
-    (0, import_node_fs.chmodSync)(dir, 448);
-  return dir;
-}
-function stateDir() {
-  return privateDir(
-    process.env.AGENT_BRIDGE_STATE_DIR ?? (process.env.XDG_RUNTIME_DIR ? (0, import_node_path.join)(process.env.XDG_RUNTIME_DIR, "agent-bridge") : (0, import_node_path.join)((0, import_node_os.tmpdir)(), `agent-bridge-${uid()}`))
-  );
-}
-var shortHash = (text) => (0, import_node_crypto.createHash)("sha256").update(text).digest("hex").slice(0, 16);
-function socketPath(name, dir) {
-  if (process.platform === "win32")
-    return `\\\\.\\pipe\\agent-bridge-${shortHash(dir)}-${name}`;
-  const path = (0, import_node_path.join)(dir, `${name}.sock`);
-  if (Buffer.byteLength(path) <= 100) return path;
-  const short = privateDir(`/tmp/agent-bridge-${uid()}`);
-  return (0, import_node_path.join)(short, `${shortHash(path)}.sock`);
-}
-var sessionFiles = (name, dir = stateDir()) => ({
-  state: (0, import_node_path.join)(dir, `${name}.json`),
-  error: (0, import_node_path.join)(dir, `${name}.error`),
-  log: (0, import_node_path.join)(dir, `${name}.log`),
-  socket: socketPath(name, dir)
-});
-function checkName(name) {
-  if (!/^[\w.-]{1,40}$/.test(name))
-    throw new Error(
-      `Session name "${name}" must be 1-40 letters, digits, ".", "_" or "-"`
-    );
-  return name;
-}
-function isAlive(pid) {
-  try {
-    process.kill(pid, 0);
-    return true;
-  } catch (error) {
-    return error.code === "EPERM";
-  }
-}
-function removeSessionFiles(name, dir = stateDir()) {
-  const files = sessionFiles(name, dir);
-  (0, import_node_fs.rmSync)(files.state, { force: true });
-  if (process.platform !== "win32") (0, import_node_fs.rmSync)(files.socket, { force: true });
-}
-function readState(file) {
-  try {
-    return JSON.parse((0, import_node_fs.readFileSync)(file, "utf8"));
-  } catch {
-    return null;
-  }
-}
-function listSessions(dir = stateDir()) {
-  const live = [];
-  for (const entry of (0, import_node_fs.readdirSync)(dir)) {
-    if (!entry.endsWith(".json")) continue;
-    const state = readState((0, import_node_path.join)(dir, entry));
-    if (!state) continue;
-    if (isAlive(state.pid)) live.push(state);
-    else removeSessionFiles(state.name, dir);
-  }
-  return live.sort((a, b) => a.startedAt - b.startedAt);
-}
-function readSession(name, dir = stateDir()) {
-  return listSessions(dir).find((s) => s.name === name) ?? null;
-}
-function pickSession(filter) {
-  if (filter.name) {
-    const named = readSession(checkName(filter.name));
-    if (!named) throw new Error(`No session named "${filter.name}" is running`);
-    return named;
-  }
-  const device = filter.device?.toLowerCase();
-  const explicit = !!(filter.metro || device || filter.transport && filter.transport !== "auto");
-  const project = projectRoot();
-  const matching = listSessions().filter(
-    (s) => (explicit || s.project === project) && (!filter.metro || s.metro === filter.metro) && (!device || s.device.name.toLowerCase().includes(device) || s.device.deviceId.toLowerCase().includes(device)) && (!filter.transport || filter.transport === "auto" || filter.transport === s.transport)
-  );
-  if (matching.length > 1)
-    throw new Error(
-      `Several sessions match (${matching.map((s) => `${s.name}: ${s.device.name} on ${s.metro}`).join("; ")}); pick one by name (--session, or --name for session stop/status), or narrow with --metro/--device`
-    );
-  return matching[0] ?? null;
-}
-
 // src/client/session/client.ts
 function openSessionLink(state) {
   return new Promise((resolve2, reject) => {
@@ -813,7 +910,9 @@ Warning: ${notice}` : ""}`);
 };
 async function connect(options = {}) {
   const timeoutMs = options.timeoutMs ?? 1e4;
-  const conn = await openConnection(options);
+  const conn = await openConnection(options).catch(async (error) => {
+    throw await explainConnectError(error, metroHost(options.metro), options.device);
+  });
   const timed = async (tool, ...args) => {
     const t0 = performance.now();
     const result = await conn.call(tool, args, timeoutMs);

package/dist/client/index.js

@@ -5,7 +5,7 @@ import {
   listDevices,
   listSessions,
   runFlow
-} from "../chunk-TA2OLPPT.js";
+} from "../chunk-3QIG7A5W.js";
 export {
   AgentBridgeCallError,
   connect,

package/dist/runtime/index.cjs

@@ -515,7 +515,12 @@ var SWITCH_HOSTS = /* @__PURE__ */ new Set(["RCTSwitch", "AndroidSwitch"]);
 var isFn = (v) => typeof v === "function";
 var isInputProps = (p) => isFn(p.onChangeText) || isFn(p.onChange) && typeof p.value !== "boolean" && ("value" in p || "defaultValue" in p || "placeholder" in p);
 var labelOf = (p) => p.accessibilityLabel ?? p["aria-label"];
-var interesting = (p) => isFn(p.onPress) || isFn(p.onValueChange) || isInputProps(p) || typeof p.testID === "string" || typeof labelOf(p) === "string" || webViewNameOf(p) !== void 0;
+function actionNamesOf(p) {
+  if (!isFn(p.onAccessibilityAction) || !Array.isArray(p.accessibilityActions)) return null;
+  return p.accessibilityActions.map((a) => a?.name).filter((name) => typeof name === "string");
+}
+var activates = (rec) => !!rec.actions && !!rec.element.actions?.includes("activate");
+var interesting = (p) => isFn(p.onPress) || actionNamesOf(p) !== null || isFn(p.onValueChange) || isInputProps(p) || typeof p.testID === "string" || typeof labelOf(p) === "string" || webViewNameOf(p) !== void 0;
 var ICON_GLYPHS = /[\uE000-\uF8FF]/g;
 function firstHost(fiber) {
   if (fiber.tag === HOST_COMPONENT) return fiber;
@@ -532,6 +537,11 @@ function absorb(rec, fiber, p) {
   const e = rec.element;
   if (!rec.input && isInputProps(p)) rec.input = fiber;
   if (!rec.press && isFn(p.onPress)) rec.press = fiber;
+  const actions = actionNamesOf(p);
+  if (!rec.actions && actions) {
+    rec.actions = fiber;
+    if (actions.length) e.actions = actions;
+  }
   const fill = (key, v) => {
     if (e[key] === void 0 && typeof v === "string") e[key] = v;
   };
@@ -617,8 +627,8 @@ var round = (r) => r && {
 var handles = (control, p, name) => !!control && isFn(p[name]) && propsOf(control)?.[name] === p[name];
 function sameControl(rec, p) {
   for (let r = rec; r; r = r.parent) {
-    if (!r.press && !r.input) continue;
-    const same = handles(r.press, p, "onPress") || handles(r.input, p, "onChangeText") || handles(r.input, p, "onChange");
+    if (!r.press && !r.input && !r.actions) continue;
+    const same = handles(r.press, p, "onPress") || handles(r.actions, p, "onAccessibilityAction") || handles(r.input, p, "onChangeText") || handles(r.input, p, "onChange");
     return same ? r : null;
   }
   return null;
@@ -648,6 +658,7 @@ function collectScreen(roots, window) {
       host,
       press: null,
       input: null,
+      actions: null,
       hidden,
       scroller,
       modal,
@@ -661,7 +672,7 @@ function collectScreen(roots, window) {
     return rec;
   };
   const buttonOf = (rec) => {
-    for (let r = rec; r; r = r.parent) if (r.press) return r;
+    for (let r = rec; r; r = r.parent) if (r.press || activates(r)) return r;
     return null;
   };
   const textHost = (host) => {
@@ -752,7 +763,7 @@ function collectScreen(roots, window) {
     rec.hidden || (rec.hidden = covers2(rec));
     const text = rec.parts.map((part) => part.text.replace(ICON_GLYPHS, "").replace(/\s+/g, " ").trim()).filter(Boolean).join(" ");
     if (text) e.text = text;
-    e.kind = e.webview !== void 0 ? "webview" : rec.input ? "input" : rec.press ? "button" : rec.parts.length ? "text" : "view";
+    e.kind = e.webview !== void 0 ? "webview" : rec.input ? "input" : rec.press || activates(rec) ? "button" : rec.parts.length ? "text" : "view";
     if (e.kind === "input" && e.editable === void 0) e.editable = true;
     const rect = measureHost(rec.host);
     e.rect = round(rect);
@@ -777,10 +788,21 @@ function collectScreen(roots, window) {
 }
 var focused = (found) => found.filter((f) => !f.hidden);
 function pressFiberOf(found) {
-  if (found.press) return found.press;
+  if (found.press) return { fiber: found.press, via: "onPress" };
+  if (activates(found)) return { fiber: found.actions, via: "accessibilityAction" };
+  for (let f = found.fiber.return; f; f = f.return) {
+    const p = propsOf(f);
+    if (!p) continue;
+    if (isFn(p.onPress)) return { fiber: f, via: "onPress" };
+    if (actionNamesOf(p)?.includes("activate")) return { fiber: f, via: "accessibilityAction" };
+  }
+  return null;
+}
+function actionFiberOf(found, name) {
+  if (found.actions && found.element.actions?.includes(name)) return found.actions;
   for (let f = found.fiber.return; f; f = f.return) {
     const p = propsOf(f);
-    if (p && isFn(p.onPress)) return f;
+    if (p && actionNamesOf(p)?.includes(name)) return f;
   }
   return null;
 }
@@ -824,7 +846,7 @@ function tiers(target) {
     (e) => fields(e) && !!e.text?.includes(text)
   ];
 }
-var labelOnly = ({ element: e, press, input }) => e.kind === "view" && !e.testID && !e.text && !e.placeholder && !press && !input;
+var labelOnly = ({ element: e, press, input, actions }) => e.kind === "view" && !e.testID && !e.text && !e.placeholder && !press && !input && !actions;
 function matchTarget(found, target) {
   checkTarget(target);
   for (const pool of [found.filter((f) => !labelOnly(f)), found.filter(labelOnly)]) {
@@ -942,13 +964,36 @@ function fillInput(found, text, options = {}) {
   return value;
 }
 var center = (rect) => rect ? { x: rect.x + rect.width / 2, y: rect.y + rect.height / 2 } : { x: 0, y: 0 };
+var disabledProps = (fiber) => {
+  const p = propsOf(fiber);
+  const state = p?.accessibilityState;
+  return p?.disabled === true || state?.disabled === true || p?.["aria-disabled"] === true;
+};
+function pressTargetOf(found, action) {
+  if (action === void 0) return pressFiberOf(found);
+  const fiber = actionFiberOf(found, action);
+  return fiber && { fiber, via: "accessibilityAction" };
+}
 function pressElement(found, options = {}) {
-  const fiber = pressFiberOf(found);
-  if (!fiber) throw new Error(`${describe(found.element)} has no onPress`);
-  if (!options.force && (found.element.disabled || propsOf(fiber)?.disabled === true))
+  const { action } = options;
+  const target = pressTargetOf(found, action);
+  if (!target) {
+    const names = found.element.actions ?? [];
+    const has = names.length ? `; it has ${names.map((a) => JSON.stringify(a)).join(", ")}` : "";
+    throw new Error(
+      action === void 0 ? `${describe(found.element)} has no onPress or "activate" accessibility action` : `${describe(found.element)} has no accessibility action ${JSON.stringify(action)}${has}`
+    );
+  }
+  const { fiber, via } = target;
+  if (!options.force && (found.element.disabled || disabledProps(fiber)))
     throw new Error(
       `${describe(found.element)} is disabled; pass {"force":true} as the last argument to press anyway`
     );
+  if (via === "accessibilityAction") {
+    const actionName = action ?? "activate";
+    handler(fiber, "onAccessibilityAction")?.(event({ actionName }));
+    return `accessibilityAction:${actionName}`;
+  }
   const { x, y } = center(found.element.rect);
   const e = () => event({
     locationX: found.element.rect ? found.element.rect.width / 2 : 0,
@@ -960,6 +1005,7 @@ function pressElement(found, options = {}) {
   handler(fiber, "onPressIn")?.(e());
   handler(fiber, "onPress")?.(e());
   handler(fiber, "onPressOut")?.(e());
+  return "onPress";
 }
 
 // src/runtime/screen/find-text.ts
@@ -1424,10 +1470,17 @@ function createScreen(env) {
       return { filled, element: reread(found).element };
     },
     async press(target, options = {}) {
-      const found = await resolve(target, (f) => !!f.press, options);
-      pressElement(found, options);
+      const { action } = options;
+      if (action !== void 0 && typeof action !== "string")
+        throw new Error(`"action" must be an accessibility action name; got ${JSON.stringify(action)}`);
+      const found = await resolve(
+        target,
+        (f) => action === void 0 ? !!f.press || f.element.kind === "button" : !!f.element.actions?.includes(action),
+        options
+      );
+      const via = pressElement(found, options);
       await settle();
-      return found.element;
+      return via === "onPress" ? found.element : { ...found.element, via };
     },
     /**
      * Scrolls the nearest scrollable of a target (or `within`, or the main one
@@ -1525,7 +1578,7 @@ function screenTools() {
       run: (text, options) => screen.findText(text, options)
     },
     "screen.snapshot": {
-      description: "Buttons, inputs, text, and testID or labelled views on screen, with rects and checked/selected/expanded state (a Switch's value is checked). Only the focused screen: unfocused tabs and stack screens, content under an open modal, display:none and accessibility-hidden subtrees are left out, and `hidden` counts the elements skipped. {all:true} lists everything, marking off-screen (onScreen:false) and hidden (hidden:true) ones. A WebView registered with the react-native-webview adapter shows as one `webview` element with its name: use webview.* inside it.",
+      description: 'Buttons, inputs, text, and testID or labelled views on screen, with rects and checked/selected/expanded state (a Switch\'s value is checked). `actions` lists the accessibility actions an element handles; one with "activate" and no onPress (a swipe-to-confirm) is a button screen.press can press. Only the focused screen: unfocused tabs and stack screens, content under an open modal, display:none and accessibility-hidden subtrees are left out, and `hidden` counts the elements skipped. {all:true} lists everything, marking off-screen (onScreen:false) and hidden (hidden:true) ones. A WebView registered with the react-native-webview adapter shows as one `webview` element with its name: use webview.* inside it.',
       run: (options) => screen.snapshot(options)
     },
     "screen.fill": {
@@ -1533,7 +1586,7 @@ function screenTools() {
       run: (target, text, options) => screen.fill(target, text, options)
     },
     "screen.press": {
-      description: `Press a button, then wait for the render. ${TARGET_HELP} Disabled elements are refused; {force:true} presses anyway, to see what the app does on tap. {scroll:true} scrolls an off-screen target into view first.`,
+      description: `Press a button, then wait for the render. ${TARGET_HELP} Disabled elements are refused; {force:true} presses anyway, to see what the app does on tap. {scroll:true} scrolls an off-screen target into view first. With no onPress it sends the "activate" accessibility action, as a screen reader's double tap does (swipe-to-confirm buttons, sliders), and the reply says via:"accessibilityAction:activate". {action:"increment"} (or any name in the element's snapshot \`actions\`) sends that action instead.`,
       run: (target, options) => screen.press(target, options)
     },
     "screen.scroll": {

package/dist/runtime/index.d.cts

@@ -82,6 +82,8 @@ type ScreenElement = {
     expanded?: boolean;
     /** A WebView registered with the react-native-webview adapter: drive it with `webview.*`. */
     webview?: string;
+    /** `accessibilityActions` it handles with `onAccessibilityAction`, e.g. `activate` on a swipe button. */
+    actions?: string[];
     rect: Rect | null;
     /** Only in `screen.snapshot({ all: true })`. */
     onScreen?: boolean;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@avasapp/agent-bridge",
-  "version": "0.4.2",
+  "version": "0.5.0",
   "description": "Let coding agents drive a running React Native app directly: seed state, flip flags, navigate and check the screen in about a millisecond per call, with no taps.",
   "type": "module",
   "license": "MIT",
@@ -103,8 +103,9 @@
     "build": "bun run generate && rm -rf dist && tsup",
     "test": "bun run generate && bun test src/",
     "typecheck": "bun run generate && tsc -p tsconfig.json --noEmit",
-    "check": "bun run typecheck && bun run test && bun run build && bun run check:gates",
+    "check": "bun run typecheck && bun run test && bun run build && bun run check:gates && bun run check:consumer-types",
     "check:gates": "node scripts/check-gates.mjs",
+    "check:consumer-types": "node scripts/check-consumer-types.mjs",
     "changeset": "changeset",
     "release": "bun run check && changeset publish",
     "prepublishOnly": "bun run check"