@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 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.25.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.85.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, data, timeoutMs = 15000) {
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) { s.close(); sessions.delete(sid); audit('session-expire', { sid: sid.slice(0, 8) }) }
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() + SESSION_TTL_MS
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() + SESSION_TTL_MS
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' }))