arena-bridge 0.7.3 → 0.7.6

package/CHANGELOG.md

@@ -4,6 +4,39 @@ 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.7.6
+
+### Added
+- Release artifacts: every tag publishes the npm archive, the python sdist and wheel, and the
+  macOS app for arm64 and x86_64 as a GitHub Release.
+- `install.sh`: one command installs the command line tool and the macOS app.
+- `feature-tree.md`: the complete feature tree of the product.
+- The ax-tree artifact opens in the app as a readable list of elements, with a switch to the raw
+  answer of the tool.
+- `mac_see` asks for the accessibility tree on its own when the first answer has no elements.
+
+### Changed
+- The README says in one line how to get past Gatekeeper.
+
+## 0.7.5
+
+### Added
+- Approvals in Telegram carry native buttons: Approve once, Approve for 3h, Deny. "Approve for 3h"
+  also opens a trust window for the same tool.
+- `arena-bridge trust --status --json` prints the trust window as JSON.
+- The native macOS app: a trust window status with the time left, an "Approve for 3 h" button,
+  local notifications when a request needs a decision, the command arguments in the work log,
+  a click-through to screenshots and accessibility trees, and a button that copies the agent prompt.
+- The app icon: `macos/ArenaBridge/Resources/AppIcon.png`, turned into an `.icns` by `build.sh`.
+
+## 0.7.4
+
+### Fixed
+- Approvals over HTTP work again: `POST /approvals/<id>` now answers with the decision instead
+  of an internal error, the local token is accepted by the API, and the agent token is refused —
+  an agent can no longer approve its own dangerous action.
+- The same rule now applies to the hub mode.
+
 ## 0.7.3
 
 ### Fixed

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-149%20passed-brightgreen.svg?style=flat-square" alt="tests">
+  <img src="https://img.shields.io/badge/tests-154%20passed-brightgreen.svg?style=flat-square" alt="tests">
 </p>
 
 <p align="center">
@@ -23,6 +23,8 @@
 
 ## Что это
 
+Полное дерево функциональности — в [feature-tree.md](feature-tree.md).
+
 Облачный агент (Arena.ai Agent Mode, Claude, Cursor, любой MCP-клиент) работает в песочнице
 с выходом в интернет, но не имеет доступа к вашему компьютеру. `arena-bridge` — это маленький
 HTTP-сервис на вашей машине: он слушает только localhost, выставляется наружу туннелем
@@ -41,16 +43,31 @@ HTTP-сервис на вашей машине: он слушает только
 
 ## Быстрый старт
 
+Одна команда ставит и командную строку, и нативное приложение для macOS:
+
+```bash
+curl -fsSL https://raw.githubusercontent.com/vernikr/arena-bridge/main/install.sh | sh
+```
+
+Или по отдельности:
+
 ```bash
-# 1. установить
-npm i -g arena-bridge
+npm i -g arena-bridge          # только командная строка
+pip install arena-bridge       # то же самое на Python
+```
 
-# 2. один раз: создать конфиг, проверить машину, поднять API + туннель
+```bash
+# 1. один раз: создать конфиг, проверить машину, поднять API + туннель
 arena-bridge setup --root ~/projects --root ~/Documents
 
-# 3. скопировать блок «Paste this into the agent chat» и вставить его в чат с агентом
+# 2. скопировать блок «Paste this into the agent chat» и вставить его в чат с агентом
 ```
 
+> **macOS и Gatekeeper.** Приложение подписано локально, поэтому при первом запуске система может
+> сказать «нельзя открыть, так как разработчик не проверен». Обойти это можно без терминала:
+> правый клик по **Arena Bridge** в «Программах» → **Открыть** → **Открыть**. Через терминал:
+> `xattr -dr com.apple.quarantine "/Applications/Arena Bridge.app"`.
+
 `setup` печатает готовый промпт и публичный URL. Дальше — просто говорите агенту задачу.
 
 Туннель под присмотром: если `cloudflared`/`ngrok` упадёт, мост поднимет его заново и сам
@@ -258,6 +275,59 @@ arena-bridge telegram inbox
 
 ---
 
+## Нативное приложение для macOS
+
+Окно, в котором всё видно и всё управляется: статус, пуск/стоп, подтверждения, журнал.
+
+```bash
+git clone https://github.com/vernikr/arena-bridge.git
+cd arena-bridge/macos/ArenaBridge
+./build.sh                                   # → dist/Arena Bridge.app
+cp -R "dist/Arena Bridge.app" /Applications/
+```
+
+Нужен только Swift из Xcode Command Line Tools (`xcode-select --install`), Xcode целиком не
+требуется. Собирается под текущую архитектуру: `ARCH=x86_64` для Intel, `ARCH=arm64` для
+Apple Silicon.
+
+| Блок в окне | Что делает |
+| --- | --- |
+| Статус | запущен/остановлен, версия, режим, число инструментов, публичный адрес, уведомления, Telegram |
+| Управление | «Запустить» / «Остановить» (служба `ai.arena.bridge`), «Настроить…», «Скопировать промпт агенту» |
+| Доверенное окно | «Открыть на 3 ч» / «Закрыть» и статус «действует ещё 2:59» |
+| Подтверждения | ожидающие запросы агента с кнопками «Разрешить» / «Разрешить на 3 ч» / «Отклонить» |
+| Журнал | команды с аргументами, клик по скриншоту или ax-tree открывает его целиком, «Сохранить…» в файл (с ax-tree) |
+
+Когда агенту нужно решение, приложение показывает системное уведомление macOS
+«Approval needed» — в строке меню и в центре уведомлений. Внутри окна запрос тоже виден
+сразу, в карточке «Подтверждения».
+
+«Настроить…» собирает конфиг, службу и запуск одной кнопкой: туннель (ngrok/cloudflared),
+зарезервированный домен, authtoken, папки для агента, Telegram (токен бота и chat id).
+
+Иконка приложения лежит в `macos/ArenaBridge/Resources/AppIcon.png`; `build.sh` сам собирает
+из неё `.icns` и кладёт в бандл.
+
+---
+
+## Подтверждения в Telegram: кнопки
+
+Под сообщением «Approval needed» появляются нативные кнопки:
+
+```
+Approve once      Approve for 3h      Deny
+```
+
+* **Approve once** — разрешить этот запрос и всё;
+* **Approve for 3h** — разрешить и открыть доверенное окно на 3 часа для этого же инструмента
+  (команды больше не спрашивают);
+* **Deny** — отклонить.
+
+Кнопки работают и в приложении на Mac, и в Telegram; сообщение в Telegram после нажатия
+переписывается на итог. Прежние команды `/approve <id>` и `/deny <id>` тоже работают.
+
+---
+
 ## Доверенное окно: работать без подтверждений
 
 ```bash
@@ -265,6 +335,7 @@ arena-bridge trust --for 2h                                   # всё, на 2
 arena-bridge trust --for 30m --tools bash                     # только команды
 arena-bridge trust --for 1h --paths ~/projects/my-app         # только эта папка
 arena-bridge trust --status
+arena-bridge trust --status --json                            # для приложений и скриптов
 arena-bridge trust --off
 ```
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "arena-bridge",
-  "version": "0.7.3",
+  "version": "0.7.6",
   "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/approvals.mjs

@@ -2,7 +2,8 @@ import fs from 'node:fs';
 import path from 'node:path';
 import crypto from 'node:crypto';
 import { APPROVALS_DIR, ensureDirs } from './config.mjs';
-import { sendTelegram } from './telegram.mjs';
+import { sendTelegram, approvalKeyboard } from './telegram.mjs';
+import { saveTrust } from './trust.mjs';
 
 const sleep = (ms) => new Promise((r) => setTimeout(r, ms));
 
@@ -43,6 +44,24 @@ export function decide(id, decision, by = 'cli') {
   return { ok: true, approval: rec };
 }
 
+/**
+ * Settle a request and, when asked, open a trust window for the same tool.
+ */
+export function settle(id, decision, by = 'cli', { trustSec = 0 } = {}) {
+  const res = decide(id, decision, by);
+  if (res.ok && trustSec > 0) {
+    const tool = res.approval?.tool;
+    saveTrust({
+      enabled: true,
+      until: Date.now() + trustSec * 1000,
+      tools: tool ? [tool] : [],
+      paths: [],
+      createdAt: Date.now(),
+    });
+  }
+  return res;
+}
+
 function redact(args) {
   const clone = { ...args };
   for (const k of Object.keys(clone)) {
@@ -82,7 +101,8 @@ export async function requestApproval(tool, args, cfg) {
       text:
         `Tool: ${tool}\n` +
         `id: ${id}\n` +
-        `Reply /approve ${id} or /deny ${id} in Telegram, or run: arena-bridge approve ${id}`,
+        `Use the buttons below, reply /approve ${id} or /deny ${id}, or run: arena-bridge approve ${id}`,
+      buttons: approvalKeyboard(id),
     }).catch(() => {});
   }
 

package/src/cli.mjs

@@ -359,6 +359,19 @@ function cmdTrust(args) {
     return;
   }
   if (args.flags.status || (!args.flags.for && !args.flags.tools && !args.flags.paths)) {
+    if (args.flags.json) {
+      const remaining = state && state.active ? Math.max(0, Math.round((state.until - Date.now()) / 1000)) : 0;
+      console.log(
+        JSON.stringify({
+          enabled: !!(state && state.active),
+          until: state && state.active ? state.until : null,
+          remaining_sec: remaining,
+          tools: state ? state.tools : [],
+          paths: state ? state.paths : [],
+        }),
+      );
+      return;
+    }
     if (!state || !state.active) {
       console.log('no active trust window (every side-effecting action needs approval)');
     } else {

package/src/direct.mjs

@@ -3,11 +3,11 @@ import fsp from 'node:fs/promises';
 import { sendJson, sendText, sendRaw, readJson, readBody, isAuthorized, bearer, safeEqual } from './http.mjs';
 import { handleMcp } from './mcp.mjs';
 import { buildPrompt } from './prompt.mjs';
-import { listApprovals, decide } from './approvals.mjs';
+import { listApprovals, decide, settle } from './approvals.mjs';
 import { checkPath } from './policy.mjs';
 import { loadConfig } from './config.mjs';
 import { tailAudit, readArtifact, auditDir } from './audit.mjs';
-import { startPoller, parseCommand, sendTelegram } from './telegram.mjs';
+import { startPoller, parseCommand, sendTelegram, answerCallback, editMessageText } from './telegram.mjs';
 
 export function createDirectServer(cfg, engine) {
   const mcpCtx = {
@@ -37,6 +37,27 @@ export function createDirectServer(cfg, engine) {
     }
   };
 
+  const handleTelegramCallback = async (cb) => {
+    const current = loadConfig();
+    const [action, id] = String(cb.data || '').split(':');
+    if (!id || !['approve', 'approve3h', 'deny'].includes(action)) {
+      await answerCallback(current, cb.callback_id, 'Unknown action');
+      return;
+    }
+    const trustSec = action === 'approve3h' ? 3 * 3600 : 0;
+    const res = settle(id, action === 'deny' ? 'deny' : 'approve', 'telegram', { trustSec });
+    const tool = res.approval?.tool || 'the tool';
+    const text = !res.ok
+      ? `Cannot ${action}: ${res.error || 'unknown error'}`
+      : action === 'deny'
+        ? `Denied ${id}`
+        : trustSec
+          ? `Approved ${id} — ${tool} is trusted for the next 3 hours`
+          : `Approved ${id}`;
+    await answerCallback(current, cb.callback_id, res.ok ? 'Done' : 'Error');
+    await editMessageText(current, { chatId: cb.chat_id, messageId: cb.message_id, text });
+  };
+
   const server = http.createServer(async (req, res) => {
     let url;
     try {
@@ -52,7 +73,7 @@ export function createDirectServer(cfg, engine) {
           ok: true,
           mode: 'direct',
           device: cfg.device,
-          version: '0.7.3',
+          version: '0.7.6',
           uptime_sec: Math.round(process.uptime()),
         });
       }
@@ -118,10 +139,20 @@ export function createDirectServer(cfg, engine) {
 
       const approveMatch = /^\/approvals\/([\w-]+)$/.exec(p);
       if (req.method === 'POST' && approveMatch) {
+        // settling a request is a local-only privilege: the agent token must not self-approve
+        const expected = loadConfig().localToken;
+        const presented = bearer(req);
+        if (!expected || !presented || !safeEqual(presented, expected)) {
+          return sendJson(res, 403, {
+            ok: false,
+            error: 'forbidden',
+            reason: 'approvals require the local token — run "arena-bridge approve <id>" on the machine',
+          });
+        }
         const body = await readJson(req, 64 * 1024);
         const decision = body.decision === 'deny' ? 'deny' : 'approve';
         const res2 = decide(approveMatch[1], decision, 'api');
-        return sendJson(res2.ok ? 200 : 400, res2);
+        return sendJson(res, res2.ok ? 200 : 400, res2);
       }
 
       if (req.method === 'POST' && p === '/exec') {
@@ -178,7 +209,7 @@ export function createDirectServer(cfg, engine) {
     }
   });
 
-  const poller = startPoller(cfg, { onMessage: handleTelegramMessage });
+  const poller = startPoller(cfg, { onMessage: handleTelegramMessage, onCallback: handleTelegramCallback });
   server.on('close', () => poller?.stop());
 
   return server;

package/src/http.mjs

@@ -72,6 +72,8 @@ export function bearer(req) {
 
 export function isAuthorized(req, cfg) {
   const token = bearer(req);
-  if (!token || !cfg.token) return false;
-  return safeEqual(token, cfg.token);
+  if (!token) return false;
+  if (cfg.token && safeEqual(token, cfg.token)) return true;
+  // the local token is for the machine owner: approvals and trust
+  return !!(cfg.localToken && safeEqual(token, cfg.localToken));
 }

package/src/hub.mjs

@@ -1,6 +1,6 @@
 import http from 'node:http';
 import crypto from 'node:crypto';
-import { sendJson, sendText, readJson, readBody, isAuthorized, safeEqual } from './http.mjs';
+import { sendJson, sendText, readJson, readBody, isAuthorized, bearer, safeEqual } from './http.mjs';
 import { handleMcp } from './mcp.mjs';
 import { buildPrompt } from './prompt.mjs';
 import { toolCatalog } from './engine.mjs';
@@ -90,7 +90,7 @@ export function createHubServer(cfg) {
         return sendJson(res, 200, {
           ok: true,
           mode: 'hub',
-          version: '0.7.3',
+          version: '0.7.6',
           devices: [...devices.keys()],
         });
       }
@@ -158,10 +158,20 @@ export function createHubServer(cfg) {
 
       const approveMatch = /^\/approvals\/([\w-]+)$/.exec(p);
       if (req.method === 'POST' && approveMatch) {
+        // settling a request is a local-only privilege: the agent token must not self-approve
+        const expected = loadConfig().localToken;
+        const presented = bearer(req);
+        if (!expected || !presented || !safeEqual(presented, expected)) {
+          return sendJson(res, 403, {
+            ok: false,
+            error: 'forbidden',
+            reason: 'approvals require the local token — run "arena-bridge approve <id>" on the machine',
+          });
+        }
         const body = await readJson(req, 64 * 1024);
         const decision = body.decision === 'deny' ? 'deny' : 'approve';
         const r = decide(approveMatch[1], decision, 'api');
-        return sendJson(r.ok ? 200 : 400, r);
+        return sendJson(res, r.ok ? 200 : 400, r);
       }
 
       if (req.method === 'POST' && p === '/exec') {

package/src/mac.mjs

@@ -218,6 +218,18 @@ export function macTools(cfg = {}) {
       const denied = isPermissionError(json, res);
       if (res.exit_code !== 0 && !denied && !UNKNOWN.test(res.stderr || '')) break;
     }
+    // no elements yet: ask for the accessibility tree on its own
+    if (!best || !best.elements.length) {
+      for (const variant of [
+        ['see', '--tree', '--no-screenshot', '--json', ...targetFlags(args)],
+        ['see', '--tree', '--no-screenshot', '--no-remote', '--json', ...targetFlags(args)],
+      ]) {
+        const res = await run(peek(), variant, { timeout: 60 });
+        const json = parseJson(res.stdout);
+        const elements = collectElements(json);
+        if (elements.length) return { res, json, elements, variant };
+      }
+    }
     return best;
   };
 

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.7.3' },
+            serverInfo: { name: 'arena-bridge', version: '0.7.6' },
             instructions:
               'Tools operate the user\'s own machine. Dangerous operations may return ' +
               'PROTECTED and require a local human approval.',

package/src/telegram.mjs

@@ -110,10 +110,23 @@ export function rateOk(limit = RATE_LIMIT, windowMs = RATE_WINDOW_MS) {
   return true;
 }
 
+/**
+ * The inline keyboard under an approval message: approve once, approve for 3 hours, deny.
+ */
+export function approvalKeyboard(id) {
+  return [
+    [
+      { text: 'Approve once', callback_data: `approve:${id}` },
+      { text: 'Approve for 3h', callback_data: `approve3h:${id}` },
+    ],
+    [{ text: 'Deny', callback_data: `deny:${id}` }],
+  ];
+}
+
 /**
  * Send a text message to one of the allowed chats.
  */
-export async function sendTelegram(cfg, { text, chatId, title, silent } = {}) {
+export async function sendTelegram(cfg, { text, chatId, title, silent, buttons } = {}) {
   const s = telegramSettings(cfg);
   if (!s.enabled) {
     return {
@@ -151,17 +164,16 @@ export async function sendTelegram(cfg, { text, chatId, title, silent } = {}) {
     };
   }
   const text_ = title ? `${title}\n${body}` : body;
-  let res = await apiCall(cfg, 'sendMessage', {
+  const markup = buttons && buttons.length ? { inline_keyboard: buttons } : undefined;
+  const payload = {
     chat_id: target,
     text: text_,
     disable_notification: !!silent,
-  });
+    ...(markup ? { reply_markup: markup } : {}),
+  };
+  let res = await apiCall(cfg, 'sendMessage', payload);
   if (!res.ok && /parse entities|Markdown/i.test(res.reason || '')) {
-    res = await apiCall(cfg, 'sendMessage', {
-      chat_id: target,
-      text: text_,
-      disable_notification: !!silent,
-    });
+    res = await apiCall(cfg, 'sendMessage', payload);
   }
   if (!res.ok) return res;
   return {
@@ -172,6 +184,29 @@ export async function sendTelegram(cfg, { text, chatId, title, silent } = {}) {
   };
 }
 
+/**
+ * Acknowledge a button press so Telegram stops showing the spinner.
+ */
+export async function answerCallback(cfg, callbackId, text = '') {
+  if (!callbackId) return { ok: false, error: 'telegram_no_callback' };
+  const payload = { callback_query_id: callbackId };
+  if (text) payload.text = String(text).slice(0, 200);
+  return apiCall(cfg, 'answerCallbackQuery', payload);
+}
+
+/**
+ * Replace the text of a message and drop its keyboard.
+ */
+export async function editMessageText(cfg, { chatId, messageId, text } = {}) {
+  if (!chatId || !messageId) return { ok: false, error: 'telegram_no_message' };
+  return apiCall(cfg, 'editMessageText', {
+    chat_id: chatId,
+    message_id: messageId,
+    text: String(text ?? ''),
+    reply_markup: { inline_keyboard: [] },
+  });
+}
+
 /* ------------------------------------------------------------------ *
  * inbox
  * ------------------------------------------------------------------ */
@@ -258,7 +293,7 @@ export function parseCommand(text) {
  * Poll the bot for incoming messages and hand them to the callback.
  * Returns a handle with stop().
  */
-export function startPoller(cfg, { onMessage } = {}) {
+export function startPoller(cfg, { onMessage, onCallback } = {}) {
   const s = telegramSettings(cfg);
   if (!s.enabled || !s.poll) return null;
   let stopped = false;
@@ -282,7 +317,7 @@ export function startPoller(cfg, { onMessage } = {}) {
         const res = await apiCall(fresh(), 'getUpdates', {
           offset,
           timeout: 20,
-          allowed_updates: ['message'],
+          allowed_updates: ['message', 'callback_query'],
         });
         if (!res.ok) {
           const state = readState();
@@ -301,6 +336,26 @@ export function startPoller(cfg, { onMessage } = {}) {
           const state = readState();
           state.offset = offset;
           writeState(state);
+          const cb = upd.callback_query;
+          if (cb) {
+            const item = {
+              id: upd.update_id,
+              callback_id: cb.id,
+              data: cb.data || '',
+              chat_id: cb.message?.chat?.id ?? null,
+              message_id: cb.message?.message_id ?? null,
+              from: cb.from?.username || cb.from?.first_name || 'unknown',
+              date: cb.message?.date || null,
+            };
+            if (onCallback) {
+              try {
+                await onCallback(item);
+              } catch {
+                /* the callback must not kill the loop */
+              }
+            }
+            continue;
+          }
           const msg = upd.message;
           if (!msg) continue;
           const item = {