@dotrino/remote-agent 0.33.1 → 0.35.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
@@ -23,6 +23,11 @@ Provee lo común — y **solo** eso:
23
23
  - **Autodescubrimiento** de agentes por label (`listVaultDevices` + filtro).
24
24
  - **Auditoría** (`sessions.log` JSONL).
25
25
 
26
+ - **Mensajes grandes**: la sesión saluda al pilar en las dos puntas (`helloTo`), y con
27
+ `@dotrino/proxy-client` ≥ 0.49.0 en las dos lo que no cabe en un mensaje del camino sale en
28
+ partes y llega entero y en orden. La app manda objetos enteros y no trocea nada. Con una punta
29
+ más vieja (las apps nativas, todavía) va entero, como antes (0.34.0).
30
+
26
31
  **No sabe nada de PTY ni de IA.** Cada app define sus payloads de dominio
27
32
  (terminal pasa `{type:'cmd',...}`, ia pasa `{type:'msg',...}`) y su renderer.
28
33
 
@@ -33,7 +38,7 @@ Provee lo común — y **solo** eso:
33
38
  | `@dotrino/remote-agent` | isomórfico | `e2e` (`makeEphemeral`/`deriveKey`/`seal`/`open`) + constantes de protocolo |
34
39
  | `@dotrino/remote-agent/agent` | Node | `startRemoteAgent(opts)` |
35
40
  | `@dotrino/remote-agent/client` | navegador | `RemoteAgentClient` |
36
- | `@dotrino/remote-agent/link` | Node | `enroll`, `selfLink`, `isSelfLink`, `loadLink`, `saveLink`, `dataDir`, `parseQr`, `identityFromLink`, `clientLink`, `renewLink` |
41
+ | `@dotrino/remote-agent/link` | Node | `enroll`, `enrollInteractive` (pregunta la invitación en la terminal, 0.35.0), `selfLink`, `isSelfLink`, `loadLink`, `saveLink`, `dataDir`, `parseQr`, `identityFromLink`, `clientLink`, `renewLink` |
37
42
  | `@dotrino/remote-agent/discover` | navegador | `listAgentsByLabel`, `probeAgents` |
38
43
  | `@dotrino/remote-agent/instances` | Node | `resolveInstance`, `listInstances`, `lockInstance`, `instancesRoot` |
39
44
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@dotrino/remote-agent",
3
- "version": "0.33.1",
3
+ "version": "0.35.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",
@@ -81,7 +81,7 @@
81
81
  },
82
82
  "devDependencies": {
83
83
  "@dotrino/identity": "0.136.0",
84
- "@dotrino/proxy-client": "0.47.0",
84
+ "@dotrino/proxy-client": "0.49.0",
85
85
  "@dotrino/vault": "0.115.0",
86
86
  "@types/node": "22.20.1",
87
87
  "@types/ws": "8.18.1",
package/src/agent.js CHANGED
@@ -552,6 +552,11 @@ export async function startRemoteAgent (opts = {}) {
552
552
  sessions.set(sid, session)
553
553
  audit('session-open', { sid: sid.slice(0, 8), device: (await pubkeyId(chk.device)).slice(0, 8).toUpperCase() })
554
554
  send(from, { type: ACK, sid, ack, signature: ackSig, cert: link.cert })
555
+ // EL SALUDO DEL PILAR: le dice a la otra punta qué entiende este cliente del transporte, y
556
+ // ella contesta con lo suyo. Con eso el pilar trocea lo grande que se manda por la sesión
557
+ // (proxy-client ≥ 0.49.0, `parts`) solo si la otra punta sabe rearmarlo. No bloquea: si no
558
+ // se puede saludar, todo va entero como antes.
559
+ try { client.helloTo(from) } catch (_) {}
555
560
  if (!opts.quiet) console.log(`[remote-agent] session ${sid.slice(0, 8)} authorized (device ${chk.device?.slice?.(0, 8) || '?'})`)
556
561
  if (opts.onSession) { try { opts.onSession(session) } catch (e) { if (!opts.quiet) console.error('[remote-agent] onSession:', /** @type {Error} */ (e).message) } }
557
562
  }
package/src/client.js CHANGED
@@ -239,6 +239,9 @@ export class RemoteAgentClient {
239
239
  const res = await acked
240
240
  try { await this._checkAck(res, eph) } catch (e) { if (res.from) this._directPeers.delete(res.from); throw e }
241
241
  this.agentToken = res.from || null
242
+ // El saludo del pilar (ver agent.js): con él, lo grande de la sesión sale en partes hacia
243
+ // un agente que las rearma (proxy-client ≥ 0.49.0). Sin él, entero como antes.
244
+ if (this.agentToken) { try { client.helloTo(this.agentToken) } catch (_) {} }
242
245
  }
243
246
 
244
247
  /**
package/src/link.js CHANGED
@@ -179,6 +179,49 @@ export async function enroll ({ qr, label = 'remote-agent', dir = dataDir(), ns
179
179
  return link
180
180
  }
181
181
 
182
+ /**
183
+ * ENLAZAR PREGUNTANDO EN LA TERMINAL: pide la invitación de `dotrino-vault pair`, la canjea y,
184
+ * mientras espera, enseña el código que hay que aprobar en la bóveda. Es lo que corre un agente
185
+ * la primera vez (`dotrino-terminal-agent`, `dotrino-remote-desktop-agent`): antes cada uno
186
+ * traía su copia. La copy de la terminal va en español, como la de los comandos que la usan.
187
+ *
188
+ * Lanza `no-tty` sin terminal delante (un servicio): enlazar necesita a alguien que pegue la
189
+ * invitación y apruebe el código.
190
+ *
191
+ * @param {{ dir: string, label: string, input?: NodeJS.ReadableStream, output?: NodeJS.WritableStream }} opts
192
+ * @returns {Promise<AgentLink>}
193
+ */
194
+ export async function enrollInteractive ({ dir, label, input = process.stdin, output = process.stdout }) {
195
+ if (!(/** @type {any} */ (input)).isTTY && input === process.stdin) {
196
+ throw Object.assign(new Error('this machine is not linked, and linking needs an interactive terminal. Run it once in a terminal, then start it as a service.'), { code: 'no-tty' })
197
+ }
198
+ const say = (/** @type {string} */ t) => { output.write(t + '\n') }
199
+ const readline = await import('node:readline')
200
+ /** @param {string} q @returns {Promise<string>} */
201
+ const ask = (q) => {
202
+ const rl = readline.createInterface({ input, output })
203
+ return new Promise((resolve) => rl.question(q, (a) => { rl.close(); resolve(a) }))
204
+ }
205
+ say('Enlazar esta máquina con tu bóveda.')
206
+ say('En el PC de tu bóveda corre `dotrino-vault pair` y copia la invitación.\n')
207
+ const qr = await parseQr(await ask('Pega la invitación y pulsa Enter:\n> '))
208
+ say('\nConectando…')
209
+ const link = await enroll({
210
+ qr,
211
+ dir,
212
+ label,
213
+ onChallenge: ({ deviceId, code }) => {
214
+ say('\n Escribe ESTE código en tu bóveda para aprobar esta máquina:')
215
+ say(` código: ${code}`)
216
+ say(` máquina: ${deviceId}`)
217
+ say(` (en el PC de la bóveda: dotrino-vault approve ${code})\n`)
218
+ say(' Esperando la aprobación…')
219
+ }
220
+ })
221
+ say('\n ✓ Máquina enlazada.\n')
222
+ return link
223
+ }
224
+
182
225
  /**
183
226
  * UNA IDENTIDAD PROPIA, SIN BÓVEDA. El aparato cumple el rol cuando no hay pieza dedicada:
184
227
  * crea sus llaves (firma y cifrado) y un acta de génesis autofirmada donde él es el único
@@ -449,4 +492,4 @@ export function clientLink (link, opts) {
449
492
  return { id: identityFromLink(link, opts), cert: link.cert, iss: link.iss, proxy: link.proxy || DEFAULT_PROXY }
450
493
  }
451
494
 
452
- export default { dataDir, loadLink, saveLink, parseQr, enroll, selfLink, isSelfLink, identityFromLink, clientLink, renewLink, renewalReason, storeRenewedCert, refreshChain }
495
+ export default { dataDir, loadLink, saveLink, parseQr, enroll, enrollInteractive, selfLink, isSelfLink, identityFromLink, clientLink, renewLink, renewalReason, storeRenewedCert, refreshChain }
@@ -88,6 +88,24 @@ export function enroll({ qr, label, dir, ns, onChallenge, timeoutMs }?: {
88
88
  }) => void) | undefined;
89
89
  timeoutMs?: number | undefined;
90
90
  }): Promise<AgentLink>;
91
+ /**
92
+ * ENLAZAR PREGUNTANDO EN LA TERMINAL: pide la invitación de `dotrino-vault pair`, la canjea y,
93
+ * mientras espera, enseña el código que hay que aprobar en la bóveda. Es lo que corre un agente
94
+ * la primera vez (`dotrino-terminal-agent`, `dotrino-remote-desktop-agent`): antes cada uno
95
+ * traía su copia. La copy de la terminal va en español, como la de los comandos que la usan.
96
+ *
97
+ * Lanza `no-tty` sin terminal delante (un servicio): enlazar necesita a alguien que pegue la
98
+ * invitación y apruebe el código.
99
+ *
100
+ * @param {{ dir: string, label: string, input?: NodeJS.ReadableStream, output?: NodeJS.WritableStream }} opts
101
+ * @returns {Promise<AgentLink>}
102
+ */
103
+ export function enrollInteractive({ dir, label, input, output }: {
104
+ dir: string;
105
+ label: string;
106
+ input?: NodeJS.ReadableStream;
107
+ output?: NodeJS.WritableStream;
108
+ }): Promise<AgentLink>;
91
109
  /**
92
110
  * UNA IDENTIDAD PROPIA, SIN BÓVEDA. El aparato cumple el rol cuando no hay pieza dedicada:
93
111
  * crea sus llaves (firma y cifrado) y un acta de génesis autofirmada donde él es el único
@@ -220,6 +238,7 @@ declare namespace _default {
220
238
  export { saveLink };
221
239
  export { parseQr };
222
240
  export { enroll };
241
+ export { enrollInteractive };
223
242
  export { selfLink };
224
243
  export { isSelfLink };
225
244
  export { identityFromLink };