@dotrino/terminal-agent 0.29.0 → 0.30.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 +17 -0
- package/bin/cli.js +31 -8
- package/package.json +4 -3
- package/update.js +98 -0
package/README.md
CHANGED
|
@@ -16,9 +16,26 @@ npx @dotrino/terminal-agent enroll # re-enlaza y corre
|
|
|
16
16
|
npx @dotrino/terminal-agent --name casa # otro agente en la misma máquina, con su enlace
|
|
17
17
|
npx @dotrino/terminal-agent list # los enlazados aquí
|
|
18
18
|
npx @dotrino/terminal-agent info # qué aparato es: su ID, su bóveda, sus permisos
|
|
19
|
+
npx @dotrino/terminal-agent update # cómo se actualiza: [--approval on|off] [--notify on|off]
|
|
19
20
|
# [--proxy wss://…] [--shell /bin/zsh] [--dir /ruta]
|
|
20
21
|
```
|
|
21
22
|
|
|
23
|
+
### Se actualiza solo
|
|
24
|
+
|
|
25
|
+
Instalado con `npm install -g` en un prefijo del usuario (nvm o similar), el agente mira una
|
|
26
|
+
vez al día si hay versión nueva, comprueba que el paquete de npm cuadra con lo que midió su
|
|
27
|
+
release de GitHub (`npm-integrity.json`) y la instala (`@dotrino/update/npm`, CONVENCIONES §15).
|
|
28
|
+
Corrido con `npx`, desde un checkout o en un prefijo de root no se toca: lo dice y, si hace
|
|
29
|
+
falta root, avisa a quien aprueba en tu cuenta.
|
|
30
|
+
|
|
31
|
+
- **Dos ajustes, de cada agente** (`update --approval on|off`, `update --notify on|off`): pedir
|
|
32
|
+
antes aprobación a tu bóveda (apagado) y avisar de que se actualizó (encendido).
|
|
33
|
+
- **Reiniciar cierra las consolas**, así que la versión nueva se instala al salir pero el
|
|
34
|
+
agente solo se reinicia cuando no queda ninguna consola abierta, y solo si hay quien lo
|
|
35
|
+
levante (systemd, pm2).
|
|
36
|
+
- `info` dice si hay una versión que se pidió y no se aprobó, o que necesita permisos de
|
|
37
|
+
administrador.
|
|
38
|
+
|
|
22
39
|
Las ventanas de esta máquina:
|
|
23
40
|
|
|
24
41
|
```sh
|
package/bin/cli.js
CHANGED
|
@@ -6,6 +6,8 @@
|
|
|
6
6
|
* dotrino-terminal-agent enroll [--name <n>] # re-enlaza (sobrescribe) y corre el agente
|
|
7
7
|
* dotrino-terminal-agent list # los agentes enlazados en esta máquina
|
|
8
8
|
* dotrino-terminal-agent info [--name <n>] # qué aparato es: su ID, su bóveda, sus permisos
|
|
9
|
+
* dotrino-terminal-agent update [--name <n>] [--approval on|off] [--notify on|off]
|
|
10
|
+
* # cómo se actualiza este agente (CONVENCIONES §15)
|
|
9
11
|
*
|
|
10
12
|
* Las ventanas de esta máquina se abren con `dotrino-terminal` (bin/terminal.js), que habla
|
|
11
13
|
* con este agente por un socket local y lo levanta si no está corriendo.
|
|
@@ -16,7 +18,7 @@
|
|
|
16
18
|
* solo comando queda enlazado y aparece solo en terminal.dotrino.com.
|
|
17
19
|
*/
|
|
18
20
|
import { createRequire } from 'node:module'
|
|
19
|
-
import {
|
|
21
|
+
import { updatePrefsCommand, updateStatusText } from '@dotrino/update/npm'
|
|
20
22
|
import { startAgent } from '../index.js'
|
|
21
23
|
import { linkInteractive, loadLink, dataDir, LABEL } from '../link.js'
|
|
22
24
|
import { listInstances, lockInstance, instancesRoot } from '@dotrino/remote-agent/instances'
|
|
@@ -34,6 +36,10 @@ if (args.includes('-h') || args.includes('--help')) {
|
|
|
34
36
|
dotrino-terminal-agent list los agentes enlazados en esta máquina
|
|
35
37
|
dotrino-terminal-agent info [--name <n>] qué aparato es: su ID (el de «dotrino-vault members»),
|
|
36
38
|
su bóveda y sus permisos. Sin red. [--json]
|
|
39
|
+
dotrino-terminal-agent update [--name <n>] cómo se actualiza este agente. Por defecto lo hace
|
|
40
|
+
solo y avisa de que lo hizo:
|
|
41
|
+
--approval on|off pedir antes aprobación a tu bóveda
|
|
42
|
+
--notify on|off avisar cuando se actualiza
|
|
37
43
|
opciones: [--name <n>] [--proxy <wss://…>] [--shell <bin>] [--dir <ruta>]
|
|
38
44
|
[--local] no enlazar ahora: atender solo a las ventanas de esta máquina
|
|
39
45
|
|
|
@@ -49,6 +55,20 @@ if (cmd === 'list') {
|
|
|
49
55
|
process.exit(0)
|
|
50
56
|
}
|
|
51
57
|
|
|
58
|
+
// `update`: los dos ajustes de ESTE agente (`@dotrino/update/npm`). Sin banderas, los enseña.
|
|
59
|
+
if (cmd === 'update') {
|
|
60
|
+
let r
|
|
61
|
+
try {
|
|
62
|
+
const dir = opt('--dir') || dataDir(opt('--name'))
|
|
63
|
+
// Solo las banderas de este comando: `--name`/`--dir` ya eligieron la carpeta.
|
|
64
|
+
const own = args.slice(1).filter((a, i, all) => !['--name', '--dir'].includes(a) && !['--name', '--dir'].includes(all[i - 1]))
|
|
65
|
+
r = updatePrefsCommand(own, { dir, lang: 'es' })
|
|
66
|
+
} catch (e) { console.error('error:', e.message); process.exit(1) }
|
|
67
|
+
if (!r.handled) { console.error('uso: dotrino-terminal-agent update [--name <n>] [--approval on|off] [--notify on|off]'); process.exit(2) }
|
|
68
|
+
;(r.ok ? console.log : console.error)(r.text)
|
|
69
|
+
process.exit(r.ok ? 0 : 2)
|
|
70
|
+
}
|
|
71
|
+
|
|
52
72
|
// `info`: la pieza común del ecosistema (`@dotrino/vault/device-info`). Lo que se viene a
|
|
53
73
|
// mirar es el ID, para buscarlo en el acta.
|
|
54
74
|
if (cmd === 'info') {
|
|
@@ -57,7 +77,11 @@ if (cmd === 'info') {
|
|
|
57
77
|
const link = loadLink(dir)
|
|
58
78
|
if (!link) { console.error(`Este agente no está enlazado (${dir}). Enlázalo con: dotrino-terminal-agent`); process.exit(1) }
|
|
59
79
|
const info = await deviceInfo(link, { kind: LABEL, name: opt('--dir') ? null : dir.split(/[\\/]/).pop(), version: VERSION, dir })
|
|
60
|
-
|
|
80
|
+
// Lo pendiente de su actualización (se pidió y no se aprobó, o necesita permisos de
|
|
81
|
+
// administrador), si hay algo que decir. Sin red: sale de lo apuntado en su carpeta.
|
|
82
|
+
const pending = updateStatusText({ dir, current: VERSION, lang: 'es' })
|
|
83
|
+
if (args.includes('--json')) console.log(JSON.stringify(pending ? { ...info, update: pending } : info, null, 2))
|
|
84
|
+
else console.log(formatDeviceInfo(info) + (pending ? '\n' + pending : ''))
|
|
61
85
|
} catch (e) { console.error('error:', e.message); process.exit(1) }
|
|
62
86
|
process.exit(0)
|
|
63
87
|
}
|
|
@@ -87,15 +111,14 @@ try {
|
|
|
87
111
|
console.log(' ventanas de esta máquina:', agent.socket)
|
|
88
112
|
if (agent.remote) console.log(' máquina:', agent.machineId, '(tus otros aparatos pueden abrir estas consolas)\n')
|
|
89
113
|
else console.log(' sin enlazar: solo ventanas de esta máquina. Para abrirlas desde otros aparatos: dotrino-terminal-agent enroll\n')
|
|
90
|
-
// §15:
|
|
91
|
-
|
|
92
|
-
|
|
93
|
-
|
|
94
|
-
})
|
|
114
|
+
// §15: se actualiza solo. Mira al arrancar y una vez al día; pedir aprobación y avisar son
|
|
115
|
+
// ajustes de este agente (`dotrino-terminal-agent update`). Solo se reinicia sin consolas.
|
|
116
|
+
const { startSelfUpdate } = await import('../update.js')
|
|
117
|
+
const stopUpdates = startSelfUpdate({ dir, version: VERSION, agent })
|
|
95
118
|
// Mantener vivo el servicio aunque stdin no sea una TTY (systemd/pm2/`nohup </dev/null`):
|
|
96
119
|
// el socket del proxio va `unref`'d, así que sin esto el proceso saldría al arrancar.
|
|
97
120
|
const keepAlive = setInterval(() => {}, 1 << 30)
|
|
98
|
-
const bye = () => { clearInterval(keepAlive); agent.close(); process.exit(0) }
|
|
121
|
+
const bye = () => { clearInterval(keepAlive); stopUpdates(); agent.close(); process.exit(0) }
|
|
99
122
|
process.on('SIGINT', bye); process.on('SIGTERM', bye)
|
|
100
123
|
} catch (e) {
|
|
101
124
|
console.error('error:', e.message)
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@dotrino/terminal-agent",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.30.0",
|
|
4
4
|
"description": "Dotrino Terminal: las ventanas de esta máquina (dotrino-terminal) y su agente, que deja abrir esas mismas consolas desde los otros aparatos de tu cuenta, cifrado punto a punto.",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"bin": {
|
|
@@ -18,6 +18,7 @@
|
|
|
18
18
|
"link.js",
|
|
19
19
|
"local.js",
|
|
20
20
|
"title.js",
|
|
21
|
+
"update.js",
|
|
21
22
|
"bin"
|
|
22
23
|
],
|
|
23
24
|
"scripts": {
|
|
@@ -29,8 +30,8 @@
|
|
|
29
30
|
"@dotrino/identity": "0.107.2",
|
|
30
31
|
"@dotrino/proxy-client": "0.30.3",
|
|
31
32
|
"@dotrino/remote-agent": "0.18.0",
|
|
32
|
-
"@dotrino/update": "0.
|
|
33
|
-
"@dotrino/vault": "0.
|
|
33
|
+
"@dotrino/update": "0.5.0",
|
|
34
|
+
"@dotrino/vault": "0.82.0",
|
|
34
35
|
"@xterm/addon-serialize": "0.13.0",
|
|
35
36
|
"@xterm/headless": "5.5.0",
|
|
36
37
|
"jsonc-parser": "3.3.1",
|
package/update.js
ADDED
|
@@ -0,0 +1,98 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* update.js — este agente SE ACTUALIZA SOLO (CONVENCIONES §15, dueño 2026-10-08).
|
|
3
|
+
*
|
|
4
|
+
* Lo que mira, verifica e instala es `@dotrino/update/npm`; a quién se pregunta y a quién se
|
|
5
|
+
* avisa es `@dotrino/vault/service`. Aquí solo se juntan las dos piezas con lo que es propio
|
|
6
|
+
* de este agente: dónde vive su enlace y cuándo puede reiniciarse.
|
|
7
|
+
*
|
|
8
|
+
* Los dos ajustes son de CADA agente (`dotrino-terminal-agent update --approval|--notify`),
|
|
9
|
+
* no de la bóveda: por defecto se actualiza sin preguntar y avisa de que lo hizo.
|
|
10
|
+
*
|
|
11
|
+
* REINICIAR MATA LAS CONSOLAS (viven en este proceso, `consoles.js`), así que la versión
|
|
12
|
+
* nueva se instala en cuanto sale pero el agente solo se va cuando no queda ninguna consola
|
|
13
|
+
* abierta. Tumbarle a alguien la shell en la que está trabajando para estrenar una versión
|
|
14
|
+
* es justo lo contrario de lo que se quiere.
|
|
15
|
+
*/
|
|
16
|
+
import { watchSelfUpdateNpm } from '@dotrino/update/npm'
|
|
17
|
+
import { vaultUpdateHooks } from '@dotrino/vault/service'
|
|
18
|
+
import { loadLink } from './link.js'
|
|
19
|
+
|
|
20
|
+
export const PKG = '@dotrino/terminal-agent'
|
|
21
|
+
export const REPO = 'imdotrino/dotrino-terminal'
|
|
22
|
+
/** Este repo también lleva la PWA y el escritorio: las releases del agente van con prefijo. */
|
|
23
|
+
export const releaseTag = (version) => `agent-v${version}`
|
|
24
|
+
|
|
25
|
+
/** Cada cuánto se mira si ya no quedan consolas para reiniciar con la versión instalada. */
|
|
26
|
+
export const IDLE_CHECK_MS = 60_000
|
|
27
|
+
|
|
28
|
+
const fail = (code, message) => Object.assign(new Error(message), { code })
|
|
29
|
+
|
|
30
|
+
/**
|
|
31
|
+
* Lo que este agente le dice a SU bóveda sobre actualizarse: los tres ganchos de
|
|
32
|
+
* `vaultUpdateHooks` (`@dotrino/vault/service`), armados EN CADA LLAMADA con el enlace leído
|
|
33
|
+
* del disco. El papel se renueva mientras el agente corre, y el agente puede arrancar sin
|
|
34
|
+
* enlace y enlazarse después: una conexión fijada al arrancar se quedaría vieja.
|
|
35
|
+
*
|
|
36
|
+
* @param {{ dir: string, product?: string, log?: (m: string) => void, load?: (dir: string) => any, make?: (o: any) => any }} o
|
|
37
|
+
* @returns {{ mayUpdate: Function, onUpdated: Function, onNeedsRoot: Function }}
|
|
38
|
+
*/
|
|
39
|
+
export function vaultHooks ({ dir, product = PKG, log = console.log, load = loadLink, make = vaultUpdateHooks }) {
|
|
40
|
+
const now = () => {
|
|
41
|
+
const link = load(dir)
|
|
42
|
+
if (!link?.device || !link.cert || !link.iss) return null
|
|
43
|
+
return make({ product, log, proxyUrl: link.proxy || 'wss://proxy.dotrino.com', masterPubkey: link.iss, device: link.device, cert: link.cert })
|
|
44
|
+
}
|
|
45
|
+
return {
|
|
46
|
+
// true = sí · false = no, o pasó el día sin respuesta · lanza = no se pudo preguntar.
|
|
47
|
+
async mayUpdate (u) {
|
|
48
|
+
const h = now()
|
|
49
|
+
// Sin enlace no hay a quién preguntar. No es un «no»: se dice y se reintenta.
|
|
50
|
+
if (!h) throw fail('not-linked', 'this agent is not linked to a vault, so there is nobody to ask')
|
|
51
|
+
return h.mayUpdate(u)
|
|
52
|
+
},
|
|
53
|
+
// Sin enlace no hay bóveda a la que contárselo: no es un fallo que reintentar.
|
|
54
|
+
async onUpdated (u) { await now()?.onUpdated(u) },
|
|
55
|
+
async onNeedsRoot (u) { await now()?.onNeedsRoot(u) }
|
|
56
|
+
}
|
|
57
|
+
}
|
|
58
|
+
|
|
59
|
+
/**
|
|
60
|
+
* Enciende la autoactualización del agente que ya corre.
|
|
61
|
+
*
|
|
62
|
+
* `dir` es la carpeta de datos de ESTA instancia (su enlace y sus ajustes) y `version` la
|
|
63
|
+
* que está en marcha. Lo demás es para las pruebas.
|
|
64
|
+
*
|
|
65
|
+
* @param { dir: string, version: string, agent: { consoles: { consoles: Map<string, unknown> }, close: () => void }, exit?: (code: number) => void,
|
|
66
|
+
* log?: (m: string) => void, watch?: (o: any) => (() => void), hooks?: object, idleCheckMs?: number } o
|
|
67
|
+
* @returns {() => void} para dejar de mirar
|
|
68
|
+
*/
|
|
69
|
+
export function startSelfUpdate ({ dir, version, agent, exit = (code) => process.exit(code), log = console.log, watch = watchSelfUpdateNpm, hooks = vaultHooks({ dir, log }), idleCheckMs = IDLE_CHECK_MS }) {
|
|
70
|
+
let waiting = null
|
|
71
|
+
const open = () => agent.consoles.consoles.size
|
|
72
|
+
const restart = (v) => {
|
|
73
|
+
log(`[terminal-agent] restarting to run ${v}`)
|
|
74
|
+
agent.close()
|
|
75
|
+
exit(0)
|
|
76
|
+
}
|
|
77
|
+
const stop = watch({
|
|
78
|
+
pkg: PKG,
|
|
79
|
+
current: version,
|
|
80
|
+
repo: REPO,
|
|
81
|
+
tag: releaseTag,
|
|
82
|
+
dir,
|
|
83
|
+
...hooks,
|
|
84
|
+
onInstalled: ({ version: v, restart: supervised }) => {
|
|
85
|
+
// Sin quien lo levante no se va: irse sería apagarle el servicio al usuario.
|
|
86
|
+
if (!supervised) return
|
|
87
|
+
if (!open()) return restart(v)
|
|
88
|
+
if (waiting) return
|
|
89
|
+
log(`[terminal-agent] ${v} is installed · ${open()} console(s) open, so it restarts when none is left`)
|
|
90
|
+
waiting = setInterval(() => { if (!open()) { clearInterval(waiting); waiting = null; restart(v) } }, idleCheckMs)
|
|
91
|
+
waiting.unref?.()
|
|
92
|
+
},
|
|
93
|
+
log
|
|
94
|
+
})
|
|
95
|
+
return () => { if (waiting) { clearInterval(waiting); waiting = null } stop?.() }
|
|
96
|
+
}
|
|
97
|
+
|
|
98
|
+
export default { startSelfUpdate, vaultHooks, PKG, REPO, releaseTag }
|