@dotrino/remote-agent 0.25.0 → 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 +4 -0
- package/package.json +3 -2
- package/src/agent.js +17 -1
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.
|
|
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.
|
|
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,
|
|
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):
|