@dotrino/remote-agent 0.22.5 → 0.23.1

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/README.md CHANGED
@@ -67,6 +67,11 @@ const ra = await startRemoteAgent({
67
67
  // bóveda de que OTRO aparato de la cuenta hizo algo (la terminal: tres claves mal seguidas).
68
68
  // Quien aprueba lo ve y bloquea o ignora; bloqueado, no saluda a ningún agente (`code: 'blocked'`)
69
69
  // y la lista viaja con la de revocados y queda en el enlace (`link.blocked`). ra.isBlocked(pub).
70
+ // ra.checkCap(session.device, 'admin') → { ok: true, seq } | { ok: false, code } (0.23.1): ¿ese
71
+ // aparato tiene ese permiso en el acta? Se pregunta en CADA petición contra el acta de confianza
72
+ // del agente, nunca contra lo que diga el cliente. Si no pasa, trae el acta en el momento (con
73
+ // freno) y vuelve a juzgar. Códigos: `no-record` (no hay acta de confianza: no se sabe),
74
+ // `not-in-record`, `missing-cap`. ra.record() → esa acta (o null).
70
75
  // ra.client → el WebSocketProxyClient ya conectado e identificado bajo esta
71
76
  // máquina. Si tu agente necesita algo más del transporte (anunciarse en un
72
77
  // canal, por ejemplo), REUSA este: abrir una segunda conexión sería un segundo
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@dotrino/remote-agent",
3
- "version": "0.22.5",
3
+ "version": "0.23.1",
4
4
  "description": "Middleware compartido del ecosistema Dotrino para apps de agente remoto cifrado punto a punto (handshake E2E, emparejamiento SAS con vault, revocación, descubrimiento). Lo consumen dotrino-terminal (PTY) y dotrino-ia (chat con IA).",
5
5
  "type": "module",
6
6
  "main": "./index.js",
package/src/agent.js CHANGED
@@ -103,7 +103,7 @@ export class AgentSession {
103
103
  }
104
104
 
105
105
  /**
106
- * Arranca el agente. Devuelve `{ machine, machineId, master, client, reportIncident, isBlocked, close }`.
106
+ * Arranca el agente. Devuelve `{ machine, machineId, master, client, reportIncident, isBlocked, checkCap, record, close }`.
107
107
  *
108
108
  * @param {object} opts
109
109
  * @param {string} [opts.label] qué agente es (`terminal-agent`, `ia-agent`…): lo contesta el pong
@@ -491,12 +491,38 @@ export async function startRemoteAgent (opts = {}) {
491
491
  else if (payload.type === 'vault.admin.event' && (payload.body?.ev === 'blocked' || payload.body?.ev === 'unblocked')) refreshRevocations().catch(() => {})
492
492
  })
493
493
 
494
+ /**
495
+ * ¿PUEDE ESTE APARATO `cap` según el acta? Para la app que atiende la sesión y tiene que
496
+ * decidir algo más que «abrir sesión» (un servicio que solo deja administrar a quien tiene
497
+ * `admin`). Se pregunta en CADA petición contra el acta de confianza del agente —la misma
498
+ * con la que se juzga el saludo—, nunca contra lo que diga el cliente.
499
+ *
500
+ * Si no pasa, se trae el acta en el momento y se juzga otra vez (con el freno de `catchUp`):
501
+ * un permiso recién concedido no espera al tic de cinco minutos.
502
+ *
503
+ * Sin repliegue: sin acta no se sabe, y se dice con su código.
504
+ * @returns {Promise<{ ok: true, seq: number } | { ok: false, code: 'no-record'|'not-in-record'|'missing-cap' }>}
505
+ */
506
+ async function checkCap (pub, cap) {
507
+ if (typeof pub !== 'string' || !pub || typeof cap !== 'string' || !cap) throw Object.assign(new Error('checkCap: pub and cap are required'), { code: 'bad-request' })
508
+ const look = () => {
509
+ const acta = trustedActa()
510
+ if (!acta) return { ok: false, code: 'no-record' }
511
+ if (!(acta.members || []).some((m) => m?.pub === pub)) return { ok: false, code: 'not-in-record' }
512
+ if (!memberCan(acta, pub, cap)) return { ok: false, code: 'missing-cap' }
513
+ return { ok: true, seq: acta.seq }
514
+ }
515
+ let r = look()
516
+ if (!r.ok && await catchUp()) r = look()
517
+ return r
518
+ }
519
+
494
520
  if (!opts.quiet) {
495
521
  console.log(`[remote-agent] agent running · machine ${myId} · vault ${(await pubkeyId(master)).slice(0, 16)} · proxy ${proxyUrl}`)
496
522
  }
497
523
  if (opts.onReady) { try { opts.onReady({ machine: myPub, machineId: myId, master }) } catch (_) {} }
498
524
 
499
- return { machine: myPub, machineId: myId, master, client, reportIncident, isBlocked: (pub) => blockedSet.has(pub), close: stop }
525
+ return { machine: myPub, machineId: myId, master, client, reportIncident, isBlocked: (pub) => blockedSet.has(pub), checkCap, record: trustedActa, close: stop }
500
526
  }
501
527
 
502
528
  export default { startRemoteAgent }