arena-bridge 0.7.3 → 0.7.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/CHANGELOG.md CHANGED
@@ -4,6 +4,24 @@ All notable changes to this project are documented here.
4
4
  The format follows [Keep a Changelog](https://keepachangelog.com/) and the project uses
5
5
  [Semantic Versioning](https://semver.org/).
6
6
 
7
+ ## 0.7.5
8
+
9
+ ### Added
10
+ - Approvals in Telegram carry native buttons: Approve once, Approve for 3h, Deny. "Approve for 3h"
11
+ also opens a trust window for the same tool.
12
+ - `arena-bridge trust --status --json` prints the trust window as JSON.
13
+ - The native macOS app: a trust window status with the time left, an "Approve for 3 h" button,
14
+ local notifications when a request needs a decision, the command arguments in the work log,
15
+ a click-through to screenshots and accessibility trees, and a button that copies the agent prompt.
16
+
17
+ ## 0.7.4
18
+
19
+ ### Fixed
20
+ - Approvals over HTTP work again: `POST /approvals/<id>` now answers with the decision instead
21
+ of an internal error, the local token is accepted by the API, and the agent token is refused —
22
+ an agent can no longer approve its own dangerous action.
23
+ - The same rule now applies to the hub mode.
24
+
7
25
  ## 0.7.3
8
26
 
9
27
  ### Fixed
package/README.md CHANGED
@@ -258,6 +258,33 @@ arena-bridge telegram inbox
258
258
 
259
259
  ---
260
260
 
261
+ ## Нативное приложение для macOS
262
+
263
+ Окно, в котором всё видно и всё управляется: статус, пуск/стоп, подтверждения, журнал.
264
+
265
+ ```bash
266
+ git clone https://github.com/vernikr/arena-bridge.git
267
+ cd arena-bridge/macos/ArenaBridge
268
+ ./build.sh # → dist/Arena Bridge.app
269
+ cp -R "dist/Arena Bridge.app" /Applications/
270
+ ```
271
+
272
+ Нужен только Swift из Xcode Command Line Tools (`xcode-select --install`), Xcode целиком не
273
+ требуется. Собирается под текущую архитектуру: `ARCH=x86_64` для Intel, `ARCH=arm64` для
274
+ Apple Silicon.
275
+
276
+ | Блок в окне | Что делает |
277
+ | --- | --- |
278
+ | Статус | запущен/остановлен, версия, режим, число инструментов, публичный адрес, Telegram |
279
+ | Управление | «Запустить» / «Остановить» (служба `ai.arena.bridge`) и «Настроить…» |
280
+ | Подтверждения | ожидающие запросы агента с кнопками «Разрешить» / «Отклонить» |
281
+ | Журнал | последние записи, фильтр по инструменту, «Сохранить…» в файл |
282
+
283
+ «Настроить…» собирает конфиг, службу и запуск одной кнопкой: туннель (ngrok/cloudflared),
284
+ зарезервированный домен, authtoken, папки для агента, Telegram (токен бота и chat id).
285
+
286
+ ---
287
+
261
288
  ## Доверенное окно: работать без подтверждений
262
289
 
263
290
  ```bash
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "arena-bridge",
3
- "version": "0.7.3",
3
+ "version": "0.7.5",
4
4
  "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.",
5
5
  "type": "module",
6
6
  "bin": {
package/src/approvals.mjs CHANGED
@@ -2,7 +2,8 @@ import fs from 'node:fs';
2
2
  import path from 'node:path';
3
3
  import crypto from 'node:crypto';
4
4
  import { APPROVALS_DIR, ensureDirs } from './config.mjs';
5
- import { sendTelegram } from './telegram.mjs';
5
+ import { sendTelegram, approvalKeyboard } from './telegram.mjs';
6
+ import { saveTrust } from './trust.mjs';
6
7
 
7
8
  const sleep = (ms) => new Promise((r) => setTimeout(r, ms));
8
9
 
@@ -43,6 +44,24 @@ export function decide(id, decision, by = 'cli') {
43
44
  return { ok: true, approval: rec };
44
45
  }
45
46
 
47
+ /**
48
+ * Settle a request and, when asked, open a trust window for the same tool.
49
+ */
50
+ export function settle(id, decision, by = 'cli', { trustSec = 0 } = {}) {
51
+ const res = decide(id, decision, by);
52
+ if (res.ok && trustSec > 0) {
53
+ const tool = res.approval?.tool;
54
+ saveTrust({
55
+ enabled: true,
56
+ until: Date.now() + trustSec * 1000,
57
+ tools: tool ? [tool] : [],
58
+ paths: [],
59
+ createdAt: Date.now(),
60
+ });
61
+ }
62
+ return res;
63
+ }
64
+
46
65
  function redact(args) {
47
66
  const clone = { ...args };
48
67
  for (const k of Object.keys(clone)) {
@@ -82,7 +101,8 @@ export async function requestApproval(tool, args, cfg) {
82
101
  text:
83
102
  `Tool: ${tool}\n` +
84
103
  `id: ${id}\n` +
85
- `Reply /approve ${id} or /deny ${id} in Telegram, or run: arena-bridge approve ${id}`,
104
+ `Use the buttons below, reply /approve ${id} or /deny ${id}, or run: arena-bridge approve ${id}`,
105
+ buttons: approvalKeyboard(id),
86
106
  }).catch(() => {});
87
107
  }
88
108
 
package/src/cli.mjs CHANGED
@@ -359,6 +359,19 @@ function cmdTrust(args) {
359
359
  return;
360
360
  }
361
361
  if (args.flags.status || (!args.flags.for && !args.flags.tools && !args.flags.paths)) {
362
+ if (args.flags.json) {
363
+ const remaining = state && state.active ? Math.max(0, Math.round((state.until - Date.now()) / 1000)) : 0;
364
+ console.log(
365
+ JSON.stringify({
366
+ enabled: !!(state && state.active),
367
+ until: state && state.active ? state.until : null,
368
+ remaining_sec: remaining,
369
+ tools: state ? state.tools : [],
370
+ paths: state ? state.paths : [],
371
+ }),
372
+ );
373
+ return;
374
+ }
362
375
  if (!state || !state.active) {
363
376
  console.log('no active trust window (every side-effecting action needs approval)');
364
377
  } else {
package/src/direct.mjs CHANGED
@@ -3,11 +3,11 @@ import fsp from 'node:fs/promises';
3
3
  import { sendJson, sendText, sendRaw, readJson, readBody, isAuthorized, bearer, safeEqual } from './http.mjs';
4
4
  import { handleMcp } from './mcp.mjs';
5
5
  import { buildPrompt } from './prompt.mjs';
6
- import { listApprovals, decide } from './approvals.mjs';
6
+ import { listApprovals, decide, settle } from './approvals.mjs';
7
7
  import { checkPath } from './policy.mjs';
8
8
  import { loadConfig } from './config.mjs';
9
9
  import { tailAudit, readArtifact, auditDir } from './audit.mjs';
10
- import { startPoller, parseCommand, sendTelegram } from './telegram.mjs';
10
+ import { startPoller, parseCommand, sendTelegram, answerCallback, editMessageText } from './telegram.mjs';
11
11
 
12
12
  export function createDirectServer(cfg, engine) {
13
13
  const mcpCtx = {
@@ -37,6 +37,27 @@ export function createDirectServer(cfg, engine) {
37
37
  }
38
38
  };
39
39
 
40
+ const handleTelegramCallback = async (cb) => {
41
+ const current = loadConfig();
42
+ const [action, id] = String(cb.data || '').split(':');
43
+ if (!id || !['approve', 'approve3h', 'deny'].includes(action)) {
44
+ await answerCallback(current, cb.callback_id, 'Unknown action');
45
+ return;
46
+ }
47
+ const trustSec = action === 'approve3h' ? 3 * 3600 : 0;
48
+ const res = settle(id, action === 'deny' ? 'deny' : 'approve', 'telegram', { trustSec });
49
+ const tool = res.approval?.tool || 'the tool';
50
+ const text = !res.ok
51
+ ? `Cannot ${action}: ${res.error || 'unknown error'}`
52
+ : action === 'deny'
53
+ ? `Denied ${id}`
54
+ : trustSec
55
+ ? `Approved ${id} — ${tool} is trusted for the next 3 hours`
56
+ : `Approved ${id}`;
57
+ await answerCallback(current, cb.callback_id, res.ok ? 'Done' : 'Error');
58
+ await editMessageText(current, { chatId: cb.chat_id, messageId: cb.message_id, text });
59
+ };
60
+
40
61
  const server = http.createServer(async (req, res) => {
41
62
  let url;
42
63
  try {
@@ -52,7 +73,7 @@ export function createDirectServer(cfg, engine) {
52
73
  ok: true,
53
74
  mode: 'direct',
54
75
  device: cfg.device,
55
- version: '0.7.3',
76
+ version: '0.7.5',
56
77
  uptime_sec: Math.round(process.uptime()),
57
78
  });
58
79
  }
@@ -118,10 +139,20 @@ export function createDirectServer(cfg, engine) {
118
139
 
119
140
  const approveMatch = /^\/approvals\/([\w-]+)$/.exec(p);
120
141
  if (req.method === 'POST' && approveMatch) {
142
+ // settling a request is a local-only privilege: the agent token must not self-approve
143
+ const expected = loadConfig().localToken;
144
+ const presented = bearer(req);
145
+ if (!expected || !presented || !safeEqual(presented, expected)) {
146
+ return sendJson(res, 403, {
147
+ ok: false,
148
+ error: 'forbidden',
149
+ reason: 'approvals require the local token — run "arena-bridge approve <id>" on the machine',
150
+ });
151
+ }
121
152
  const body = await readJson(req, 64 * 1024);
122
153
  const decision = body.decision === 'deny' ? 'deny' : 'approve';
123
154
  const res2 = decide(approveMatch[1], decision, 'api');
124
- return sendJson(res2.ok ? 200 : 400, res2);
155
+ return sendJson(res, res2.ok ? 200 : 400, res2);
125
156
  }
126
157
 
127
158
  if (req.method === 'POST' && p === '/exec') {
@@ -178,7 +209,7 @@ export function createDirectServer(cfg, engine) {
178
209
  }
179
210
  });
180
211
 
181
- const poller = startPoller(cfg, { onMessage: handleTelegramMessage });
212
+ const poller = startPoller(cfg, { onMessage: handleTelegramMessage, onCallback: handleTelegramCallback });
182
213
  server.on('close', () => poller?.stop());
183
214
 
184
215
  return server;
package/src/http.mjs CHANGED
@@ -72,6 +72,8 @@ export function bearer(req) {
72
72
 
73
73
  export function isAuthorized(req, cfg) {
74
74
  const token = bearer(req);
75
- if (!token || !cfg.token) return false;
76
- return safeEqual(token, cfg.token);
75
+ if (!token) return false;
76
+ if (cfg.token && safeEqual(token, cfg.token)) return true;
77
+ // the local token is for the machine owner: approvals and trust
78
+ return !!(cfg.localToken && safeEqual(token, cfg.localToken));
77
79
  }
package/src/hub.mjs CHANGED
@@ -1,6 +1,6 @@
1
1
  import http from 'node:http';
2
2
  import crypto from 'node:crypto';
3
- import { sendJson, sendText, readJson, readBody, isAuthorized, safeEqual } from './http.mjs';
3
+ import { sendJson, sendText, readJson, readBody, isAuthorized, bearer, safeEqual } from './http.mjs';
4
4
  import { handleMcp } from './mcp.mjs';
5
5
  import { buildPrompt } from './prompt.mjs';
6
6
  import { toolCatalog } from './engine.mjs';
@@ -90,7 +90,7 @@ export function createHubServer(cfg) {
90
90
  return sendJson(res, 200, {
91
91
  ok: true,
92
92
  mode: 'hub',
93
- version: '0.7.3',
93
+ version: '0.7.5',
94
94
  devices: [...devices.keys()],
95
95
  });
96
96
  }
@@ -158,10 +158,20 @@ export function createHubServer(cfg) {
158
158
 
159
159
  const approveMatch = /^\/approvals\/([\w-]+)$/.exec(p);
160
160
  if (req.method === 'POST' && approveMatch) {
161
+ // settling a request is a local-only privilege: the agent token must not self-approve
162
+ const expected = loadConfig().localToken;
163
+ const presented = bearer(req);
164
+ if (!expected || !presented || !safeEqual(presented, expected)) {
165
+ return sendJson(res, 403, {
166
+ ok: false,
167
+ error: 'forbidden',
168
+ reason: 'approvals require the local token — run "arena-bridge approve <id>" on the machine',
169
+ });
170
+ }
161
171
  const body = await readJson(req, 64 * 1024);
162
172
  const decision = body.decision === 'deny' ? 'deny' : 'approve';
163
173
  const r = decide(approveMatch[1], decision, 'api');
164
- return sendJson(r.ok ? 200 : 400, r);
174
+ return sendJson(res, r.ok ? 200 : 400, r);
165
175
  }
166
176
 
167
177
  if (req.method === 'POST' && p === '/exec') {
package/src/mcp.mjs CHANGED
@@ -48,7 +48,7 @@ export async function handleMcp(req, res, ctx) {
48
48
  mcpResponse(id, {
49
49
  protocolVersion: PROTOCOL_VERSION,
50
50
  capabilities: { tools: { listChanged: false } },
51
- serverInfo: { name: 'arena-bridge', version: '0.7.3' },
51
+ serverInfo: { name: 'arena-bridge', version: '0.7.5' },
52
52
  instructions:
53
53
  'Tools operate the user\'s own machine. Dangerous operations may return ' +
54
54
  'PROTECTED and require a local human approval.',
package/src/telegram.mjs CHANGED
@@ -110,10 +110,23 @@ export function rateOk(limit = RATE_LIMIT, windowMs = RATE_WINDOW_MS) {
110
110
  return true;
111
111
  }
112
112
 
113
+ /**
114
+ * The inline keyboard under an approval message: approve once, approve for 3 hours, deny.
115
+ */
116
+ export function approvalKeyboard(id) {
117
+ return [
118
+ [
119
+ { text: 'Approve once', callback_data: `approve:${id}` },
120
+ { text: 'Approve for 3h', callback_data: `approve3h:${id}` },
121
+ ],
122
+ [{ text: 'Deny', callback_data: `deny:${id}` }],
123
+ ];
124
+ }
125
+
113
126
  /**
114
127
  * Send a text message to one of the allowed chats.
115
128
  */
116
- export async function sendTelegram(cfg, { text, chatId, title, silent } = {}) {
129
+ export async function sendTelegram(cfg, { text, chatId, title, silent, buttons } = {}) {
117
130
  const s = telegramSettings(cfg);
118
131
  if (!s.enabled) {
119
132
  return {
@@ -151,17 +164,16 @@ export async function sendTelegram(cfg, { text, chatId, title, silent } = {}) {
151
164
  };
152
165
  }
153
166
  const text_ = title ? `${title}\n${body}` : body;
154
- let res = await apiCall(cfg, 'sendMessage', {
167
+ const markup = buttons && buttons.length ? { inline_keyboard: buttons } : undefined;
168
+ const payload = {
155
169
  chat_id: target,
156
170
  text: text_,
157
171
  disable_notification: !!silent,
158
- });
172
+ ...(markup ? { reply_markup: markup } : {}),
173
+ };
174
+ let res = await apiCall(cfg, 'sendMessage', payload);
159
175
  if (!res.ok && /parse entities|Markdown/i.test(res.reason || '')) {
160
- res = await apiCall(cfg, 'sendMessage', {
161
- chat_id: target,
162
- text: text_,
163
- disable_notification: !!silent,
164
- });
176
+ res = await apiCall(cfg, 'sendMessage', payload);
165
177
  }
166
178
  if (!res.ok) return res;
167
179
  return {
@@ -172,6 +184,29 @@ export async function sendTelegram(cfg, { text, chatId, title, silent } = {}) {
172
184
  };
173
185
  }
174
186
 
187
+ /**
188
+ * Acknowledge a button press so Telegram stops showing the spinner.
189
+ */
190
+ export async function answerCallback(cfg, callbackId, text = '') {
191
+ if (!callbackId) return { ok: false, error: 'telegram_no_callback' };
192
+ const payload = { callback_query_id: callbackId };
193
+ if (text) payload.text = String(text).slice(0, 200);
194
+ return apiCall(cfg, 'answerCallbackQuery', payload);
195
+ }
196
+
197
+ /**
198
+ * Replace the text of a message and drop its keyboard.
199
+ */
200
+ export async function editMessageText(cfg, { chatId, messageId, text } = {}) {
201
+ if (!chatId || !messageId) return { ok: false, error: 'telegram_no_message' };
202
+ return apiCall(cfg, 'editMessageText', {
203
+ chat_id: chatId,
204
+ message_id: messageId,
205
+ text: String(text ?? ''),
206
+ reply_markup: { inline_keyboard: [] },
207
+ });
208
+ }
209
+
175
210
  /* ------------------------------------------------------------------ *
176
211
  * inbox
177
212
  * ------------------------------------------------------------------ */
@@ -258,7 +293,7 @@ export function parseCommand(text) {
258
293
  * Poll the bot for incoming messages and hand them to the callback.
259
294
  * Returns a handle with stop().
260
295
  */
261
- export function startPoller(cfg, { onMessage } = {}) {
296
+ export function startPoller(cfg, { onMessage, onCallback } = {}) {
262
297
  const s = telegramSettings(cfg);
263
298
  if (!s.enabled || !s.poll) return null;
264
299
  let stopped = false;
@@ -282,7 +317,7 @@ export function startPoller(cfg, { onMessage } = {}) {
282
317
  const res = await apiCall(fresh(), 'getUpdates', {
283
318
  offset,
284
319
  timeout: 20,
285
- allowed_updates: ['message'],
320
+ allowed_updates: ['message', 'callback_query'],
286
321
  });
287
322
  if (!res.ok) {
288
323
  const state = readState();
@@ -301,6 +336,26 @@ export function startPoller(cfg, { onMessage } = {}) {
301
336
  const state = readState();
302
337
  state.offset = offset;
303
338
  writeState(state);
339
+ const cb = upd.callback_query;
340
+ if (cb) {
341
+ const item = {
342
+ id: upd.update_id,
343
+ callback_id: cb.id,
344
+ data: cb.data || '',
345
+ chat_id: cb.message?.chat?.id ?? null,
346
+ message_id: cb.message?.message_id ?? null,
347
+ from: cb.from?.username || cb.from?.first_name || 'unknown',
348
+ date: cb.message?.date || null,
349
+ };
350
+ if (onCallback) {
351
+ try {
352
+ await onCallback(item);
353
+ } catch {
354
+ /* the callback must not kill the loop */
355
+ }
356
+ }
357
+ continue;
358
+ }
304
359
  const msg = upd.message;
305
360
  if (!msg) continue;
306
361
  const item = {