bare-agent 0.4.0 → 0.4.1

package/README.md

@@ -73,14 +73,15 @@ Every piece works alone — take what you need, ignore the rest.
 | **Stream** | Structured event emitter. Pipe as JSONL, subscribe in-process, or custom transport |
 | **Errors** | Typed hierarchy — `ProviderError`, `ToolError`, `TimeoutError`, `MaxRoundsError`, `CircuitOpenError` |
 | **Browsing** | Web navigation, clicking, typing, reading via `barebrowse`. Two modes: library tools (inline snapshots, pass to Loop) or CLI session (disk-based snapshots, token-efficient for multi-step flows) |
+| **Mobile** | Android + iOS device control via `baremobile`. Same two modes: library tools (`createMobileTools` — action tools auto-return snapshots) or CLI session (`baremobile` CLI — disk-based snapshots) |
 
 **Providers:** OpenAI-compatible (OpenAI, OpenRouter, Groq, vLLM, LM Studio), Anthropic, Ollama, CLIPipe (any CLI tool via stdin/stdout with real-time streaming), Fallback, or bring your own (one method: `generate`). All return the same shape — swap freely.
 
-**Tools:** Any function is a tool. REST APIs, MCP servers, CLI commands, shell scripts — if it's a function, it works. Built-in: `barebrowse` for web browsing (optional) — library tools for inline results or CLI session mode for token-efficient disk-based snapshots.
+**Tools:** Any function is a tool. REST APIs, MCP servers, CLI commands, shell scripts — if it's a function, it works. Built-in: `barebrowse` for web browsing, `baremobile` for Android + iOS device control (both optional) — library tools for inline results or CLI session mode for token-efficient disk-based snapshots.
 
 **Cross-language:** Runs as a subprocess. Communicate via JSONL on stdin/stdout from Python, Go, Rust, Ruby, Java, or anything that can spawn a process. Ready-made wrappers in [`contrib/`](contrib/README.md).
 
-**Deps:** 0 required. Optional: `cron-parser` (cron expressions), `better-sqlite3` (SQLite store), `barebrowse` (web browsing).
+**Deps:** 0 required. Optional: `cron-parser` (cron expressions), `better-sqlite3` (SQLite store), `barebrowse` (web browsing), `baremobile` (Android + iOS device control).
 
 ---
 
@@ -141,9 +142,9 @@ Three vanilla JS modules. Zero dependencies. Same API patterns.
 
 | | [**bareagent**](https://npmjs.com/package/bare-agent) | [**barebrowse**](https://npmjs.com/package/barebrowse) | [**baremobile**](https://npmjs.com/package/baremobile) |
 |---|---|---|---|
-| **Does** | Gives agents a think→act loop | Gives agents a real browser | Gives agents an Android device |
+| **Does** | Gives agents a think→act loop | Gives agents a real browser | Gives agents Android + iOS devices |
 | **How** | Goal in → coordinated actions out | URL in → pruned snapshot out | Screen in → pruned snapshot out |
-| **Replaces** | LangChain, CrewAI, AutoGen | Playwright, Selenium, Puppeteer | Appium, Espresso, UIAutomator2 |
+| **Replaces** | LangChain, CrewAI, AutoGen | Playwright, Selenium, Puppeteer | Appium, Espresso, XCUITest |
 | **Interfaces** | Library · CLI · subprocess | Library · CLI · MCP | Library · CLI · MCP |
 | **Solo or together** | Orchestrates both as tools | Works standalone | Works standalone |
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bare-agent",
-  "version": "0.4.0",
+  "version": "0.4.1",
   "files": [
     "index.js",
     "src/",

package/tools/mobile.js

@@ -173,6 +173,19 @@ async function createMobileTools(opts = {}) {
         return buf.toString('base64');
       },
     },
+    {
+      name: 'mobile_tap_xy',
+      description: 'Tap by pixel coordinates on the mobile screen. Use when elements lack refs. Returns updated snapshot.',
+      parameters: {
+        type: 'object',
+        properties: {
+          x: { type: 'number', description: 'X coordinate' },
+          y: { type: 'number', description: 'Y coordinate' },
+        },
+        required: ['x', 'y'],
+      },
+      execute: async ({ x, y }) => actionAndSnapshot((page) => page.tapXY(x, y)),
+    },
   ];
 
   // Android-only tools
@@ -191,19 +204,6 @@ async function createMobileTools(opts = {}) {
         },
         execute: async ({ action, extras }) => actionAndSnapshot((page) => page.intent(action, extras || {})),
       },
-      {
-        name: 'mobile_tap_xy',
-        description: 'Tap by pixel coordinates on the mobile screen. Use when elements lack refs. Returns updated snapshot.',
-        parameters: {
-          type: 'object',
-          properties: {
-            x: { type: 'number', description: 'X coordinate' },
-            y: { type: 'number', description: 'Y coordinate' },
-          },
-          required: ['x', 'y'],
-        },
-        execute: async ({ x, y }) => actionAndSnapshot((page) => page.tapXY(x, y)),
-      },
       {
         name: 'mobile_tap_grid',
         description: 'Tap by grid cell (e.g. "C5") for vision-based fallback. Use with mobile_grid to get cell layout. Returns updated snapshot.',
@@ -245,6 +245,24 @@ async function createMobileTools(opts = {}) {
     });
   }
 
+  // Find tools (both platforms, no device call — reads refMap from last snapshot)
+  tools.push({
+    name: 'mobile_find_text',
+    description: 'Find an interactive element by visible text or accessibility label. Searches the refMap from the last snapshot — no device call. Returns the ref number or null if not found.',
+    parameters: {
+      type: 'object',
+      properties: {
+        text: { type: 'string', description: 'Text or label substring to search for' },
+      },
+      required: ['text'],
+    },
+    execute: async ({ text }) => {
+      const page = await getPage();
+      const ref = page.findByText(text);
+      return ref !== null && ref !== undefined ? ref : null;
+    },
+  });
+
   // Wait tools (both platforms)
   tools.push(
     {