@dotrino/remote-agent 0.25.0 → 0.27.0
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 +4 -0
- package/package.json +3 -2
- package/src/agent.js +30 -5
package/README.md
CHANGED
|
@@ -46,6 +46,10 @@ import { startRemoteAgent } from '@dotrino/remote-agent/agent'
|
|
|
46
46
|
|
|
47
47
|
const ra = await startRemoteAgent({
|
|
48
48
|
label: 'ia-agent',
|
|
49
|
+
// Qué es y qué necesita del acta (`@dotrino/compat` ≥ 0.5.0). Va firmado en lo que se le pide
|
|
50
|
+
// a la bóveda, y la bóveda enseña lo que falte en la fila de este aparato. `sign` lo pone el
|
|
51
|
+
// pilar: sin él no se abre ninguna sesión.
|
|
52
|
+
product: 'ia-agent', version: pkg.version, needs: ['store'],
|
|
49
53
|
proxyUrl: 'wss://proxy.dotrino.com', // opcional
|
|
50
54
|
dir: '/home/yo/.local/share/dotrino-ia-agent', // opcional
|
|
51
55
|
quiet: false,
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@dotrino/remote-agent",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.27.0",
|
|
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",
|
|
@@ -26,6 +26,7 @@
|
|
|
26
26
|
"type-check": "tsc --noEmit"
|
|
27
27
|
},
|
|
28
28
|
"dependencies": {
|
|
29
|
+
"@dotrino/compat": "0.5.0",
|
|
29
30
|
"ws": "8.21.0"
|
|
30
31
|
},
|
|
31
32
|
"engines": {
|
|
@@ -49,7 +50,7 @@
|
|
|
49
50
|
"peerDependencies": {
|
|
50
51
|
"@dotrino/identity": ">=0.121.7",
|
|
51
52
|
"@dotrino/proxy-client": ">=0.36.1",
|
|
52
|
-
"@dotrino/vault": ">=0.
|
|
53
|
+
"@dotrino/vault": ">=0.90.0"
|
|
53
54
|
},
|
|
54
55
|
"devDependencies": {
|
|
55
56
|
"@dotrino/identity": "0.121.7",
|
package/src/agent.js
CHANGED
|
@@ -30,6 +30,10 @@ import { makeEphemeral, deriveKey, seal, open } from '../e2e.js'
|
|
|
30
30
|
import { makeCatchUp } from './catch-up.js'
|
|
31
31
|
import { HS, ACK, DATA, PING, PONG, ERROR, VMSG, SIGN_SCOPE, SESSION_TTL_MS, SESSION_GONE_MS, REVOKE_REFRESH_MS, DEFAULT_PROXY } from '../protocol.js'
|
|
32
32
|
import { loadLink, saveLink, dataDir, renewalReason, storeRenewedCert } from './link.js'
|
|
33
|
+
import { declare } from '@dotrino/compat'
|
|
34
|
+
import { VAULT_PROTOCOL, VAULT_SPEAKS } from '@dotrino/vault/protocol'
|
|
35
|
+
|
|
36
|
+
const PKG_VERSION = JSON.parse(fs.readFileSync(new URL('../package.json', import.meta.url), 'utf8')).version
|
|
33
37
|
|
|
34
38
|
/** Sesión cifrada con un dispositivo cliente. La app recibe esto en `onSession`. */
|
|
35
39
|
export class AgentSession {
|
|
@@ -117,8 +121,13 @@ export class AgentSession {
|
|
|
117
121
|
* @param {()=>void} [opts.onReady] agente listo y escuchando.
|
|
118
122
|
* @param {boolean} [opts.quiet] sin logs.
|
|
119
123
|
* @param {number} [opts.sessionGoneMs] cuánto se espera a un cliente cuya conexión se fue (`SESSION_GONE_MS`).
|
|
124
|
+
* @param {number} [opts.sessionTtlMs] cuánto dura una sesión sin mensajes (`SESSION_TTL_MS`, 30 min).
|
|
120
125
|
* @param {number} [opts.netLogMs] cada cuánto van al log las estadísticas de red (5 min).
|
|
121
126
|
* @param {object} [opts.client] transporte ya conectado (SOLO pruebas).
|
|
127
|
+
* @param {string} [opts.product] qué producto es (`accounts`, `terminal-agent`…), para el anuncio a la bóveda.
|
|
128
|
+
* @param {string} [opts.version] su versión. Sin `product`/`version` se anuncia como `remote-agent`.
|
|
129
|
+
* @param {string[]} [opts.needs] los permisos del acta que necesita, además de `sign`, que lo
|
|
130
|
+
* añade este pilar: sin él no se abre ninguna sesión (`@dotrino/compat` ≥ 0.5.0).
|
|
122
131
|
*
|
|
123
132
|
* Devuelve además el **`client`** (el `WebSocketProxyClient` ya conectado e
|
|
124
133
|
* identificado bajo la pubkey de esta máquina). Se expone a propósito: un agente
|
|
@@ -133,6 +142,10 @@ export async function startRemoteAgent (opts = {}) {
|
|
|
133
142
|
if (!link?.device?.privateJwk || !link?.cert || !link?.iss) {
|
|
134
143
|
throw new Error('this machine is not linked: enroll your agent first')
|
|
135
144
|
}
|
|
145
|
+
const MY_DECL = declare({
|
|
146
|
+
product: opts.product || 'remote-agent', version: opts.version || PKG_VERSION,
|
|
147
|
+
protocol: VAULT_PROTOCOL, speaks: VAULT_SPEAKS, needs: ['sign', ...(opts.needs || [])]
|
|
148
|
+
})
|
|
136
149
|
const master = link.iss
|
|
137
150
|
const myPub = link.device.publickey
|
|
138
151
|
const myId = await keyLabel(myPub)
|
|
@@ -184,7 +197,11 @@ export async function startRemoteAgent (opts = {}) {
|
|
|
184
197
|
* mismo sobre para todo (`data` firmado con la D + el cert de esta máquina): lo
|
|
185
198
|
* comparten el refresco de revocaciones y la renovación del cert.
|
|
186
199
|
*/
|
|
187
|
-
async function vaultRpc (sendType, okType,
|
|
200
|
+
async function vaultRpc (sendType, okType, payload, timeoutMs = 15000) {
|
|
201
|
+
// QUÉ SOY Y QUÉ NECESITO DEL ACTA, dentro de lo firmado: la bóveda lo apunta y enseña lo que
|
|
202
|
+
// falta en la fila de este aparato (dueño, 2026-10-27). `accounts` se pasó días sin `sign`,
|
|
203
|
+
// renovando un papel que no le servía, sin que ninguna pantalla lo dijera.
|
|
204
|
+
const data = { ...payload, v: MY_DECL }
|
|
188
205
|
const { signature } = await signWithDevice({ privateJwk: link.device.privateJwk, data })
|
|
189
206
|
return new Promise((resolve, reject) => {
|
|
190
207
|
// El temporizador se LIMPIA al contestar (y no retiene el bucle de eventos):
|
|
@@ -353,12 +370,20 @@ export async function startRemoteAgent (opts = {}) {
|
|
|
353
370
|
vaultTick()
|
|
354
371
|
const revTimer = setInterval(vaultTick, REVOKE_REFRESH_MS); revTimer.unref?.()
|
|
355
372
|
|
|
373
|
+
const ttlMs = opts.sessionTtlMs ?? SESSION_TTL_MS
|
|
374
|
+
// UNA SESIÓN QUE VENCE SE LE DICE AL CLIENTE en ese momento, con el mismo `unknown-session`
|
|
375
|
+
// que recibiría al mandar algo. Antes vencía callada: la ventana de una consola quieta seguía
|
|
376
|
+
// pareciendo abierta y solo se enteraba al teclear, con la consola ya perdida (2026-11-04).
|
|
377
|
+
// Así el cliente vuelve a saludar enseguida y la app decide qué enseña.
|
|
356
378
|
const sweeper = setInterval(() => {
|
|
357
379
|
const now = Date.now()
|
|
358
380
|
for (const [sid, s] of sessions) {
|
|
359
|
-
if (now > s._exp) {
|
|
381
|
+
if (now > s._exp) {
|
|
382
|
+
s.close(); sessions.delete(sid); audit('session-expire', { sid: sid.slice(0, 8) })
|
|
383
|
+
if (!s._gone) send(s.from, { type: ERROR, code: 'unknown-session', sid, error: 'unknown or expired session' })
|
|
384
|
+
}
|
|
360
385
|
}
|
|
361
|
-
}, 60 * 1000); sweeper.unref?.()
|
|
386
|
+
}, Math.min(60 * 1000, ttlMs)); sweeper.unref?.()
|
|
362
387
|
|
|
363
388
|
async function handleHandshake (from, p) {
|
|
364
389
|
const { data, signature, cert } = p
|
|
@@ -423,7 +448,7 @@ export async function startRemoteAgent (opts = {}) {
|
|
|
423
448
|
const { signature: ackSig } = await signWithDevice({ privateJwk: link.device.privateJwk, data: ack })
|
|
424
449
|
|
|
425
450
|
const session = new AgentSession({ sid, key, from, device: chk.device, send, isDirect: typeof client.isWebRTCOpen === 'function' ? (t) => client.isWebRTCOpen(t) : null })
|
|
426
|
-
session._exp = Date.now() +
|
|
451
|
+
session._exp = Date.now() + ttlMs
|
|
427
452
|
// El papel con que entró: si después se retira (`revoked`), la sesión se cierra.
|
|
428
453
|
session._certNonce = cert.nonce || null
|
|
429
454
|
sessions.set(sid, session)
|
|
@@ -439,7 +464,7 @@ export async function startRemoteAgent (opts = {}) {
|
|
|
439
464
|
// se reinició, o venció) y vuelve a saludar solo, en vez de quedarse con un error. Se
|
|
440
465
|
// comprueba por el código, no por la frase.
|
|
441
466
|
if (!s) return send(from, { type: ERROR, code: 'unknown-session', sid: p.sid, error: 'unknown or expired session' })
|
|
442
|
-
s._exp = Date.now() +
|
|
467
|
+
s._exp = Date.now() + ttlMs
|
|
443
468
|
s.from = from
|
|
444
469
|
if (s._gone) { clearTimeout(s._gone); s._gone = null }
|
|
445
470
|
s._ingest(p.env).catch(() => send(from, { type: ERROR, error: 'invalid envelope' }))
|