@dotrino/remote-agent 0.16.0 → 0.18.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dotrino/remote-agent",
-  "version": "0.16.0",
+  "version": "0.18.0",
   "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).",
   "type": "module",
   "main": "./index.js",
@@ -47,12 +47,12 @@
   ],
   "peerDependencies": {
     "@dotrino/identity": ">=0.92.0",
-    "@dotrino/proxy-client": ">=0.29.0",
+    "@dotrino/proxy-client": ">=0.30.0",
     "@dotrino/vault": ">=0.64.0"
   },
   "devDependencies": {
     "@dotrino/identity": "0.105.0",
-    "@dotrino/proxy-client": "0.29.0",
+    "@dotrino/proxy-client": "0.30.0",
     "@dotrino/vault": "0.75.0"
   }
 }

package/src/agent.js

@@ -32,12 +32,13 @@ import { loadLink, saveLink, dataDir } from './link.js'
 
 /** Sesión cifrada con un dispositivo cliente. La app recibe esto en `onSession`. */
 class AgentSession {
-  constructor ({ sid, key, from, device, send }) {
+  constructor ({ sid, key, from, device, send, isDirect = null }) {
     this.sid = sid
     this.key = key
     this.from = from                  // token del cliente en el proxy
     this.device = device              // pubkey del dispositivo cliente
     this._send = send                 // (to, obj) => void
+    this._isDirect = isDirect         // (token) => boolean, o null si el transporte no lo sabe
     this._h = { message: [], close: [] }
     this._closed = false
   }
@@ -49,6 +50,33 @@ class AgentSession {
     if (env) this._send(this.from, { type: DATA, sid: this.sid, env })
   }
 
+  /**
+   * ¿VA YA POR EL CANAL DIRECTO (WebRTC) lo que se le mande a este cliente? Mientras sea
+   * `false`, cada `send` da la vuelta por el proxio. Sirve para que la app decida qué manda
+   * YA y qué puede esperar: nunca para dejar de mandar (subir de escalón no bloquea).
+   */
+  direct () {
+    if (this._closed || !this._isDirect) return false
+    try { return !!this._isDirect(this.from) } catch (_) { return false }
+  }
+
+  /**
+   * Espera a que abra el canal directo, como mucho `ms`. Resuelve `true` si abrió y `false`
+   * si se acabó el plazo o la sesión se cerró — en los dos casos se sigue, por donde haya.
+   */
+  whenDirect (ms = 8000) {
+    return new Promise((resolve) => {
+      const until = Date.now() + ms
+      const look = () => {
+        if (this.direct()) return resolve(true)
+        if (this._closed || Date.now() >= until) return resolve(false)
+        const t = setTimeout(look, 100)
+        t.unref?.()
+      }
+      look()
+    })
+  }
+
   on (ev, cb) { this._h[ev]?.push(cb); return this }
 
   async _ingest (env) {
@@ -77,6 +105,7 @@ class AgentSession {
  * @param {()=>void} [opts.onRevoked] se llamó al auto-borrarse por revocación.
  * @param {()=>void} [opts.onReady]   agente listo y escuchando.
  * @param {boolean} [opts.quiet]      sin logs.
+ * @param {number} [opts.netLogMs]    cada cuánto van al log las estadísticas de red (5 min).
  * @param {object} [opts.client]      transporte ya conectado (SOLO pruebas).
  *
  * Devuelve además el **`client`** (el `WebSocketProxyClient` ya conectado e
@@ -374,7 +403,7 @@ export async function startRemoteAgent (opts = {}) {
     const ack = { op: ACK, sid, seph: eph.pub, ceph: data.eph, machine: myPub, publickey: myPub, ts: Date.now() }
     const { signature: ackSig } = await signWithDevice({ privateJwk: link.device.privateJwk, data: ack })
 
-    const session = new AgentSession({ sid, key, from, device: chk.device, send })
+    const session = new AgentSession({ sid, key, from, device: chk.device, send, isDirect: typeof client.isWebRTCOpen === 'function' ? (t) => client.isWebRTCOpen(t) : null })
     session._exp = Date.now() + SESSION_TTL_MS
     sessions.set(sid, session)
     audit('session-open', { sid: sid.slice(0, 8), device: (await pubkeyId(chk.device)).slice(0, 8).toUpperCase() })
@@ -394,8 +423,18 @@ export async function startRemoteAgent (opts = {}) {
     s._ingest(p.env).catch(() => send(from, { type: ERROR, error: 'sobre inválido' }))
   }
 
+  // POR DÓNDE VA EL TRÁFICO, AL LOG. Un agente no tiene topbar: sin esto, saber si una
+  // sesión subió a WebRTC o sigue dando la vuelta por el proxio pedía una prueba aparte.
+  // Lo escribe el pilar (`logStats`), que lee los clientes del proceso; aquí solo se enciende.
+  let net = null
+  if (!opts.quiet) {
+    const { logStats } = await import('@dotrino/proxy-client')
+    net = logStats({ label: 'remote-agent', everyMs: opts.netLogMs })
+  }
+
   const stop = () => {
     clearInterval(revTimer); clearInterval(sweeper)
+    if (net) net.stop().catch(() => {})
     for (const s of sessions.values()) s.close()
     try { client.close() } catch {}
   }