@dotrino/remote-agent 0.24.1 → 0.26.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.24.1",
3
+ "version": "0.26.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 {
@@ -119,6 +123,10 @@ export class AgentSession {
119
123
  * @param {number} [opts.sessionGoneMs] cuánto se espera a un cliente cuya conexión se fue (`SESSION_GONE_MS`).
120
124
  * @param {number} [opts.netLogMs] cada cuánto van al log las estadísticas de red (5 min).
121
125
  * @param {object} [opts.client] transporte ya conectado (SOLO pruebas).
126
+ * @param {string} [opts.product] qué producto es (`accounts`, `terminal-agent`…), para el anuncio a la bóveda.
127
+ * @param {string} [opts.version] su versión. Sin `product`/`version` se anuncia como `remote-agent`.
128
+ * @param {string[]} [opts.needs] los permisos del acta que necesita, además de `sign`, que lo
129
+ * añade este pilar: sin él no se abre ninguna sesión (`@dotrino/compat` ≥ 0.5.0).
122
130
  *
123
131
  * Devuelve además el **`client`** (el `WebSocketProxyClient` ya conectado e
124
132
  * identificado bajo la pubkey de esta máquina). Se expone a propósito: un agente
@@ -133,6 +141,10 @@ export async function startRemoteAgent (opts = {}) {
133
141
  if (!link?.device?.privateJwk || !link?.cert || !link?.iss) {
134
142
  throw new Error('this machine is not linked: enroll your agent first')
135
143
  }
144
+ const MY_DECL = declare({
145
+ product: opts.product || 'remote-agent', version: opts.version || PKG_VERSION,
146
+ protocol: VAULT_PROTOCOL, speaks: VAULT_SPEAKS, needs: ['sign', ...(opts.needs || [])]
147
+ })
136
148
  const master = link.iss
137
149
  const myPub = link.device.publickey
138
150
  const myId = await keyLabel(myPub)
@@ -184,7 +196,11 @@ export async function startRemoteAgent (opts = {}) {
184
196
  * mismo sobre para todo (`data` firmado con la D + el cert de esta máquina): lo
185
197
  * comparten el refresco de revocaciones y la renovación del cert.
186
198
  */
187
- async function vaultRpc (sendType, okType, data, timeoutMs = 15000) {
199
+ async function vaultRpc (sendType, okType, payload, timeoutMs = 15000) {
200
+ // QUÉ SOY Y QUÉ NECESITO DEL ACTA, dentro de lo firmado: la bóveda lo apunta y enseña lo que
201
+ // falta en la fila de este aparato (dueño, 2026-10-27). `accounts` se pasó días sin `sign`,
202
+ // renovando un papel que no le servía, sin que ninguna pantalla lo dijera.
203
+ const data = { ...payload, v: MY_DECL }
188
204
  const { signature } = await signWithDevice({ privateJwk: link.device.privateJwk, data })
189
205
  return new Promise((resolve, reject) => {
190
206
  // El temporizador se LIMPIA al contestar (y no retiene el bucle de eventos):
package/src/discover.js CHANGED
@@ -28,15 +28,23 @@ import { PING, PONG } from '../protocol.js'
28
28
  * @param {string} [label] filtrar por servicio/label exacto (p. ej. `'content'`,
29
29
  * `'ia-agent'`). Omitir = todos los que tengan nameOf y no sean `'cli'` (un navegador
30
30
  * enrolado queda como `cli` y no atiende a nadie).
31
+ * @param {{ fresh?: boolean }} [opts] `fresh: false`: el acta guardada, sin preguntar a la
32
+ * bóveda (si no hay ninguna guardada, se pregunta igual).
31
33
  * @returns {Promise<Array<{sub:string,label:string,cn:string|null}>>} uno por miembro.
32
34
  * @throws `code: 'no-record'` si ni la bóveda ni lo guardado dan el acta: no se sabe, y no es «ninguno».
33
35
  */
34
- export async function listAgentsByLabel (id, label) {
36
+ export async function listAgentsByLabel (id, label, { fresh = true } = {}) {
35
37
  // Por su efecto: trae el acta vigente y la adopta. La lista de aparatos que devuelva —si
36
38
  // devuelve alguna— no se mira: quién es de la cuenta lo dice el acta.
39
+ //
40
+ // `fresh: false` lee primero el acta YA GUARDADA, sin preguntar a la bóveda. Es para quien
41
+ // vuelve a mirar cada pocos segundos: el panel de máquinas del agente lo hacía cada 30 s, y
42
+ // cada vez era un `vault.devices` a la cuenta que despertaba a la bóveda de Lambda y no la
43
+ // dejaba dormirse (2026-10-25). El agente ya refresca su acta solo (`REVOKE_REFRESH_MS`).
37
44
  let acta = null
38
45
  let why = null
39
- try { acta = (await id.listVaultDevices())?.acta || null } catch (e) { why = e }
46
+ if (!fresh) acta = (await id.profileActa?.().catch(() => null))?.acta || null
47
+ if (!acta) { try { acta = (await id.listVaultDevices())?.acta || null } catch (e) { why = e } }
40
48
  // La bóveda no contestó: vale el acta que ya se tiene guardada.
41
49
  if (!acta) acta = (await id.profileActa?.().catch((e) => { why = why || e; return null }))?.acta || null
42
50
  // SIN ACTA NO SE SABE quién es de la cuenta, y eso no es «no hay nadie». Devolver una lista