@dotrino/remote-agent 0.3.2 → 0.4.0

package/README.md

@@ -62,6 +62,10 @@ const ra = await startRemoteAgent({
   onRevoked () { console.log('me revocaron') }
 })
 // ra.machine, ra.machineId, ra.master, ra.close()
+// ra.client → el WebSocketProxyClient ya conectado e identificado bajo esta
+//   máquina. Si tu agente necesita algo más del transporte (anunciarse en un
+//   canal, por ejemplo), REUSA este: abrir una segunda conexión sería un segundo
+//   `identify`, una segunda identidad de transporte y una segunda cola.
 ```
 
 Enrolar la máquina (una vez, con el QR del vault):

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dotrino/remote-agent",
-  "version": "0.3.2",
+  "version": "0.4.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",
@@ -24,7 +24,7 @@
   },
   "dependencies": {
     "@dotrino/identity": "0.53.0",
-    "@dotrino/proxy-client": "0.10.0",
+    "@dotrino/proxy-client": "0.10.1",
     "ws": "8.21.0"
   },
   "engines": {

package/src/agent.js

@@ -74,6 +74,13 @@ class AgentSession {
  * @param {()=>void} [opts.onReady]   agente listo y escuchando.
  * @param {boolean} [opts.quiet]      sin logs.
  * @param {object} [opts.client]      transporte ya conectado (SOLO pruebas).
+ *
+ * Devuelve además el **`client`** (el `WebSocketProxyClient` ya conectado e
+ * identificado bajo la pubkey de esta máquina). Se expone a propósito: un agente
+ * que necesite algo más del transporte —anunciarse en un canal, por ejemplo— debe
+ * reusar ESTA conexión y no abrir otra. Dos conexiones del mismo aparato al proxy
+ * son dos identidades de transporte, dos `identify` y dos colas: exactamente el
+ * lío que este middleware existe para evitar.
  */
 export async function startRemoteAgent (opts = {}) {
   const dir = opts.dir || dataDir()
@@ -279,7 +286,7 @@ export async function startRemoteAgent (opts = {}) {
   }
   if (opts.onReady) { try { opts.onReady({ machine: myPub, machineId: myId, master }) } catch (_) {} }
 
-  return { machine: myPub, machineId: myId, master, close: stop }
+  return { machine: myPub, machineId: myId, master, client, close: stop }
 }
 
 export default { startRemoteAgent }