arena-bridge 0.6.8 → 0.6.10

package/CHANGELOG.md

@@ -4,6 +4,23 @@ All notable changes to this project are documented here.
 The format follows [Keep a Changelog](https://keepachangelog.com/) and the project uses
 [Semantic Versioning](https://semver.org/).
 
+## 0.6.10
+
+### Fixed
+- The screenshot fallback no longer relies on a Peekaboo command that was removed in v4, so the
+  bridge can still grab a picture when the accessibility tree is empty.
+- The permission message now names the exact place to fix it (System Settings → Privacy &
+  Security → Screen Recording / Accessibility → "Peekaboo Bridge") and explains that the local
+  Peekaboo runtime inherits the grant from whatever starts the bridge.
+
+## 0.6.9
+
+### Fixed
+- Desktop control survives a Peekaboo update: when the Peekaboo Bridge host loses its macOS
+  permissions (Screen Recording / Accessibility), the bridge falls back to the local Peekaboo
+  runtime and keeps working. If nothing can capture, the tool now says so instead of quietly
+  returning an empty element list.
+
 ## 0.6.8
 
 ### Added

package/README.md

@@ -12,7 +12,7 @@
   <img src="https://img.shields.io/badge/license-MIT-blue.svg?style=flat-square" alt="license">
   <img src="https://img.shields.io/badge/node-%3E%3D18-green.svg?style=flat-square" alt="node">
   <img src="https://img.shields.io/badge/dependencies-0-brightgreen.svg?style=flat-square" alt="dependencies">
-  <img src="https://img.shields.io/badge/tests-120%20passed-brightgreen.svg?style=flat-square" alt="tests">
+  <img src="https://img.shields.io/badge/tests-124%20passed-brightgreen.svg?style=flat-square" alt="tests">
 </p>
 
 <p align="center">

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "arena-bridge",
-  "version": "0.6.8",
+  "version": "0.6.10",
   "description": "Give a cloud AI agent (Arena.ai Agent Mode, Claude, Cursor, ...) controlled access to your own machine over HTTP/MCP: files, shell, Chrome and the macOS desktop, with an approval gate, trust windows and an audit log.",
   "type": "module",
   "bin": {

package/src/direct.mjs

@@ -30,7 +30,7 @@ export function createDirectServer(cfg, engine) {
           ok: true,
           mode: 'direct',
           device: cfg.device,
-          version: '0.6.8',
+          version: '0.6.10',
           uptime_sec: Math.round(process.uptime()),
         });
       }

package/src/hub.mjs

@@ -90,7 +90,7 @@ export function createHubServer(cfg) {
         return sendJson(res, 200, {
           ok: true,
           mode: 'hub',
-          version: '0.6.8',
+          version: '0.6.10',
           devices: [...devices.keys()],
         });
       }

package/src/mac.mjs

@@ -193,6 +193,7 @@ export function macTools(cfg = {}) {
         ['see', '--tree', '--no-screenshot', '--json', ...targetFlags(args)],
         ['see', '--tree', '--no-screenshot', '--no-remote', '--json', ...targetFlags(args)],
         ['see', '--tree', '--json', ...targetFlags(args)],
+        ['see', '--no-remote', '--tree', '--json', ...targetFlags(args)],
         ['see', '--json', ...targetFlags(args)],
       ];
     }
@@ -200,7 +201,8 @@ export function macTools(cfg = {}) {
       [...base, '--json', '--path', outPath],
       [...base, '--path', outPath, '--json'],
       [...base, '--no-remote', '--json', '--path', outPath],
-      ['image', '--mode', mode, ...targetFlags(args), '--json', '--path', outPath],
+      ['see', '--mode', mode, ...targetFlags(args), '--no-elements', '--json', '--path', outPath],
+      ['see', '--mode', mode, ...targetFlags(args), '--no-elements', '--no-remote', '--json', '--path', outPath],
     ];
   };
 
@@ -213,7 +215,8 @@ export function macTools(cfg = {}) {
       if (!best) best = cand;
       if (res.exit_code === 0 && cand.elements.length) return cand;
       if (res.exit_code === 0 && best.res.exit_code !== 0) best = cand;
-      if (res.exit_code !== 0 && !UNKNOWN.test(res.stderr || '')) break;
+      const denied = isPermissionError(json, res);
+      if (res.exit_code !== 0 && !denied && !UNKNOWN.test(res.stderr || '')) break;
     }
     return best;
   };
@@ -259,6 +262,15 @@ export function macTools(cfg = {}) {
         if (!outPath.ok) return { ok: false, error: outPath.error, reason: outPath.reason };
         ensureDir(path.dirname(outPath.abs));
         const seen = await collectSee(args, outPath.abs);
+        const failure = peekError(seen.json);
+        if (failure && !seen.elements.length) {
+          return {
+            ok: false,
+            error: 'peekaboo_failed',
+            reason: failure.message || String(failure.code || 'peekaboo returned an error'),
+            hint: PERMISSION_HINT,
+          };
+        }
         const elements = seen.elements.slice(0, 300);
         const saved = fs.existsSync(outPath.abs);
         if (!saved) {
@@ -867,6 +879,26 @@ export function macTools(cfg = {}) {
   ];
 }
 
+/** The Peekaboo envelope reports a host that lost its macOS permissions. */
+function peekError(json) {
+  if (!json || typeof json !== 'object') return null;
+  const err = json.error;
+  if (err && typeof err === 'object' && (err.code || err.message)) return err;
+  return null;
+}
+
+function isPermissionError(json, res) {
+  const err = peekError(json);
+  const text = `${err?.code || ''} ${err?.message || ''} ${res?.stderr || ''}`;
+  return /permission|screen recording|accessibility|event synthesizing/i.test(text);
+}
+
+const PERMISSION_HINT =
+  'macOS did not let the bridge capture the screen. This usually happens right after a Peekaboo update: ' +
+  'open System Settings → Privacy & Security → Screen Recording (and Accessibility), turn on ' +
+  '"Peekaboo Bridge" and quit and reopen Peekaboo. The bridge also falls back to the local Peekaboo ' +
+  'runtime, which needs the same grant for the app that starts the bridge (for example Terminal).';
+
 function menuFlags(args) {
   const f = [];
   if (args.app) f.push('--app', String(args.app));

package/src/mcp.mjs

@@ -48,7 +48,7 @@ export async function handleMcp(req, res, ctx) {
           mcpResponse(id, {
             protocolVersion: PROTOCOL_VERSION,
             capabilities: { tools: { listChanged: false } },
-            serverInfo: { name: 'arena-bridge', version: '0.6.8' },
+            serverInfo: { name: 'arena-bridge', version: '0.6.10' },
             instructions:
               'Tools operate the user\'s own machine. Dangerous operations may return ' +
               'PROTECTED and require a local human approval.',