@dotrino/remote-agent 0.22.4 → 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.4",
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",
@@ -47,12 +47,12 @@
47
47
  "p2p"
48
48
  ],
49
49
  "peerDependencies": {
50
- "@dotrino/identity": ">=0.121.4",
50
+ "@dotrino/identity": ">=0.121.7",
51
51
  "@dotrino/proxy-client": ">=0.36.1",
52
52
  "@dotrino/vault": ">=0.85.0"
53
53
  },
54
54
  "devDependencies": {
55
- "@dotrino/identity": "0.121.4",
55
+ "@dotrino/identity": "0.121.7",
56
56
  "@dotrino/proxy-client": "0.36.2",
57
57
  "@dotrino/vault": "0.90.2"
58
58
  }
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 }
package/src/client.js CHANGED
@@ -63,7 +63,7 @@ export class RemoteAgentClient {
63
63
  * guarda: es la política vigente del perfil, no cambia a mitad de una sesión.
64
64
  *
65
65
  * Si no se puede traer, se devuelve `null` a propósito y `verifyChain` corta con
66
- * `no-acta`. No hay repliegue: sin acta no hay con qué decidir, y no decidir es que no.
66
+ * `no-record`. No hay repliegue: sin acta no hay con qué decidir, y no decidir es que no.
67
67
  */
68
68
  async _acta () {
69
69
  if (this._actaCache !== undefined) return this._actaCache
@@ -195,10 +195,10 @@ export class RemoteAgentClient {
195
195
  //
196
196
  // CON EL ACTA, o no se juzga. Desde que el papel no vence, `verifyChain` necesita el
197
197
  // `seq` del acta y su lista de SELLADORAS: sin eso no puede decir si quien firmó el
198
- // papel del agente podía hacerlo, y contesta `no-acta` — que es lo correcto, porque
198
+ // papel del agente podía hacerlo, y contesta `no-record` — que es lo correcto, porque
199
199
  // decir «vale» sin haber comprobado nada es como entraba un papel viejo. Aquí no se le
200
200
  // pasaba: el lado del agente sí lo hacía (`contextoActa`) y este lado se quedó atrás,
201
- // así que TODA sesión moría con «el agente no está certificado por tu vault: no-acta».
201
+ // así que TODA sesión moría con «el agente no está certificado por tu vault: no-record».
202
202
  // `clientLink` no trae el acta, así que se le pide a la bóveda una vez y se guarda.
203
203
  const acta = await this._acta()
204
204
  const chk = await verifyChain({
package/src/discover.js CHANGED
@@ -29,7 +29,7 @@ import { PING, PONG } from '../protocol.js'
29
29
  * `'ia-agent'`). Omitir = todos los que tengan nameOf y no sean `'cli'` (un navegador
30
30
  * enrolado queda como `cli` y no atiende a nadie).
31
31
  * @returns {Promise<Array<{sub:string,label:string,cn:string|null}>>} uno por miembro.
32
- * @throws `code: 'no-acta'` si ni la bóveda ni lo guardado dan el acta: no se sabe, y no es «ninguno».
32
+ * @throws `code: 'no-record'` si ni la bóveda ni lo guardado dan el acta: no se sabe, y no es «ninguno».
33
33
  */
34
34
  export async function listAgentsByLabel (id, label) {
35
35
  // Por su efecto: trae el acta vigente y la adopta. La lista de aparatos que devuelva —si
@@ -43,7 +43,7 @@ export async function listAgentsByLabel (id, label) {
43
43
  // vacía aquí hacía que una máquina con la bóveda inalcanzable dijera «no tienes otras
44
44
  // máquinas» con toda tranquilidad. Se para y se dice.
45
45
  if (!acta) {
46
- throw Object.assign(new Error(`could not get the account record (acta) from the vault${why ? `: ${why.message}` : ''}`), { code: 'no-acta', cause: why || undefined })
46
+ throw Object.assign(new Error(`could not get the account record (acta) from the vault${why ? `: ${why.message}` : ''}`), { code: 'no-record', cause: why || undefined })
47
47
  }
48
48
 
49
49
  const mine = id.me?.publickey