@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 +5 -0
- package/package.json +3 -3
- package/src/agent.js +28 -2
- package/src/client.js +3 -3
- package/src/discover.js +2 -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",
|
|
@@ -47,12 +47,12 @@
|
|
|
47
47
|
"p2p"
|
|
48
48
|
],
|
|
49
49
|
"peerDependencies": {
|
|
50
|
-
"@dotrino/identity": ">=0.121.
|
|
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.
|
|
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-
|
|
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-
|
|
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-
|
|
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-
|
|
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-
|
|
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
|