@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 +5 -0
- package/package.json +1 -1
- package/src/agent.js +28 -2
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.
|
|
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 }
|