arena-bridge 0.6.8 → 0.6.9

package/CHANGELOG.md

@@ -4,6 +4,14 @@ 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.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.9",
   "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.9',
           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.9',
           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)],
       ];
     }
@@ -213,7 +214,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 +261,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 +878,25 @@ 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 =
+  'The Peekaboo host that captures the screen lost its macOS permissions (this happens after a Peekaboo update). ' +
+  'Re-grant Screen Recording and Accessibility to "Peekaboo Bridge" in System Settings → Privacy & Security, ' +
+  'or let the bridge use the local runtime (--no-remote). Run mac_permissions for the current state.';
+
 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.9' },
             instructions:
               'Tools operate the user\'s own machine. Dangerous operations may return ' +
               'PROTECTED and require a local human approval.',