@dotrino/terminal-agent 0.47.0 → 0.47.2
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 +7 -3
- package/bin/terminal.js +5 -2
- package/desktop.js +31 -2
- package/local.js +9 -2
- package/package.json +1 -1
- package/service.js +22 -7
package/README.md
CHANGED
|
@@ -182,13 +182,15 @@ de quien instala) y pide `loginctl enable-linger` para que arranque sin sesión;
|
|
|
182
182
|
LaunchAgent (`~/Library/LaunchAgents/com.dotrino.terminal-agent.<perfil>.plist`); en Windows, el valor
|
|
183
183
|
`DotrinoTerminalAgent-<perfil>` en `HKCU\Software\Microsoft\Windows\CurrentVersion\Run`, que al iniciar
|
|
184
184
|
sesión corre `dotrino-terminal-agent supervise`: se vuelve a lanzar sin ventana y levanta el agente cada
|
|
185
|
-
vez que sale (`supervisor.pid` en la carpeta del perfil).
|
|
185
|
+
vez que sale (`supervisor.pid` en la carpeta del perfil). Desde una sesión SSH el supervisor lo crea
|
|
186
|
+
WMI (`Win32_Process.Create`, con la misma línea): sshd mata al cerrar la sesión todo lo que lanzó. Ni el Programador de tareas ni un servicio de
|
|
186
187
|
Windows: los dos piden derechos que una cuenta normal no tiene. Es de usuario
|
|
187
188
|
para que el agente se siga actualizando solo (§15): con quien lo levante ya puede reiniciarse.
|
|
188
189
|
Un agente que ya corre por su cuenta no se para (cerraría sus consolas): el servicio queda
|
|
189
190
|
habilitado, y `dotrino-terminal`, cuando no encuentra agente, arranca el servicio en vez de
|
|
190
191
|
levantar uno propio. Código en `service.js`; probado con systemd en un contenedor de Fedora,
|
|
191
|
-
Windows de punta a punta en el runner `windows-latest` (`test/windows.test.mjs`)
|
|
192
|
+
Windows de punta a punta en el runner `windows-latest` (`test/windows.test.mjs`) y en una VM de
|
|
193
|
+
Windows 11 enlazada a una bóveda (`dotrino-test`, `npm run smoke:terminal-windows`), macOS solo con
|
|
192
194
|
pruebas unitarias.
|
|
193
195
|
|
|
194
196
|
## Windows
|
|
@@ -198,4 +200,6 @@ Las ventanas locales no van por un socket Unix sino por una **tubería con nombr
|
|
|
198
200
|
aleatorio y, junto con una llave, queda en `terminal.pipe` dentro de la carpeta del perfil. La ventana
|
|
199
201
|
manda la llave en su primera línea (`{ type:'local-auth', key }`) y sin ella el agente corta sin
|
|
200
202
|
contestar: la lista de tuberías la ve cualquier usuario de la máquina, la carpeta del perfil no.
|
|
201
|
-
|
|
203
|
+
En PowerShell, con la política de ejecución por defecto, npm deja `dotrino-terminal.ps1` y Windows
|
|
204
|
+
no lo deja correr: se llama `dotrino-terminal.cmd` (o se permite con
|
|
205
|
+
`Set-ExecutionPolicy -Scope CurrentUser RemoteSigned`). La app de escritorio también corre en Windows (≥ 0.2.73): lanza el cliente como `node terminal.js` (no por el `.cmd`, que metería un `cmd.exe` en medio) y habla con el agente por la misma tubería.
|
package/bin/terminal.js
CHANGED
|
@@ -202,7 +202,10 @@ function captureEarly () {
|
|
|
202
202
|
|
|
203
203
|
/** El agente de esta máquina; si no hay ninguno escuchando, lo levanta y espera a que conteste. */
|
|
204
204
|
async function agent (dir) {
|
|
205
|
-
try { return await connectLocal(dir) } catch (e) {
|
|
205
|
+
try { return await connectLocal(dir) } catch (e) {
|
|
206
|
+
if (e.code === 'EAGENTACCESS') throw new Error(t(`el agente de este perfil corre con otros permisos y no deja entrar a esta ventana (${e.cause?.code}). Reinícialo: dotrino-terminal restart`, `this profile's agent runs with other permissions and does not let this window in (${e.cause?.code}). Restart it: dotrino-terminal restart`))
|
|
207
|
+
if (e.code !== 'ENOAGENT') throw e
|
|
208
|
+
}
|
|
206
209
|
// Un agente vivo sin socket es uno anterior a las ventanas (< 0.6.0): no se levanta otro
|
|
207
210
|
// encima (tendrían la misma llave), se dice.
|
|
208
211
|
const pid = Number((() => { try { return fs.readFileSync(path.join(dir, 'agent.pid'), 'utf8') } catch (_) { return '' } })())
|
|
@@ -353,7 +356,7 @@ async function desktop () {
|
|
|
353
356
|
if (args[1] !== 'update') die(t('uso: dotrino-terminal desktop update [--check]', 'usage: dotrino-terminal desktop update [--check]'))
|
|
354
357
|
const { updateDesktop, BINARY } = await import('../desktop.js')
|
|
355
358
|
const current = opt('--current')
|
|
356
|
-
const exe = opt('--exe') || findDesktop(BINARY)
|
|
359
|
+
const exe = opt('--exe') || findDesktop(process.platform === 'win32' ? `${BINARY}.exe` : BINARY)
|
|
357
360
|
const check = args.includes('--check')
|
|
358
361
|
if (!exe && !check) die(t(`no encontré ${BINARY} en esta máquina. Bájala de https://terminal.dotrino.com/`, `could not find ${BINARY} on this machine. Get it from https://terminal.dotrino.com/`))
|
|
359
362
|
const say = (step, d) => {
|
package/desktop.js
CHANGED
|
@@ -13,6 +13,8 @@
|
|
|
13
13
|
* contraseña en esa misma ventana.
|
|
14
14
|
* · tarball — el binario es del usuario: se cambia por el nuevo, de forma atómica.
|
|
15
15
|
* · macOS — se cambia el `.app` entero.
|
|
16
|
+
* · Windows — el `.exe` es del usuario (sale de un `.zip`). Un `.exe` que está corriendo no se
|
|
17
|
+
* puede sobrescribir, pero sí renombrar: el viejo pasa a `.exe.old` y el nuevo ocupa su sitio.
|
|
16
18
|
*
|
|
17
19
|
* La ventana que ya corre sigue con la versión anterior hasta que se cierre y se vuelva a abrir.
|
|
18
20
|
*/
|
|
@@ -42,7 +44,7 @@ export const latestDesktop = (opts = {}) =>
|
|
|
42
44
|
* gestor hay se equivoca con un tarball en una máquina con `dpkg`.
|
|
43
45
|
*
|
|
44
46
|
* @param {any} [o]
|
|
45
|
-
* @returns {any} `{ ok:true, kind:'deb'|'rpm'|'tar'|'mac', app? }` o `{ ok:false, code, reason }`
|
|
47
|
+
* @returns {any} `{ ok:true, kind:'deb'|'rpm'|'tar'|'mac'|'win', app? }` o `{ ok:false, code, reason }`
|
|
46
48
|
*/
|
|
47
49
|
export function installKind ({ exe, platform = process.platform, arch = process.arch, run = execFileSync, writable = canWrite } = {}) {
|
|
48
50
|
if (!exe) return fail('no-exe', 'the desktop app was not found')
|
|
@@ -52,6 +54,11 @@ export function installKind ({ exe, platform = process.platform, arch = process.
|
|
|
52
54
|
if (!writable(path.dirname(m[1]))) return fail('not-writable', `cannot write in ${path.dirname(m[1])}`)
|
|
53
55
|
return { ok: true, kind: 'mac', app: m[1] }
|
|
54
56
|
}
|
|
57
|
+
if (platform === 'win32') {
|
|
58
|
+
if (arch !== 'x64') return fail('unsupported-arch', `there is no desktop app for ${arch}`)
|
|
59
|
+
if (!writable(path.dirname(exe))) return fail('not-writable', `cannot write in ${path.dirname(exe)}`)
|
|
60
|
+
return { ok: true, kind: 'win' }
|
|
61
|
+
}
|
|
55
62
|
if (platform !== 'linux') return fail('unsupported-platform', `there is no desktop app for ${platform}`)
|
|
56
63
|
if (arch !== 'x64') return fail('unsupported-arch', `there is no desktop app for ${arch}`)
|
|
57
64
|
const owns = (cmd, args) => { try { run(cmd, args, { stdio: 'ignore' }); return true } catch (_) { return false } }
|
|
@@ -69,7 +76,8 @@ const MATCH = {
|
|
|
69
76
|
deb: { kind: 'deb', re: /_amd64\.deb$/ },
|
|
70
77
|
rpm: { kind: 'rpm', re: /\.x86_64\.rpm$/ },
|
|
71
78
|
tar: { kind: 'tar', re: /-linux-x64\.tar\.gz$/ },
|
|
72
|
-
mac: { kind: 'mac', re: /-macos-universal\.zip$/ }
|
|
79
|
+
mac: { kind: 'mac', re: /-macos-universal\.zip$/ },
|
|
80
|
+
win: { kind: 'win', re: /-windows-x64\.zip$/ }
|
|
73
81
|
}
|
|
74
82
|
|
|
75
83
|
/** El archivo de la release que le toca a esa forma de instalación. */
|
|
@@ -146,6 +154,27 @@ export function install (file, how, { exe, run = execFileSync, uid = process.get
|
|
|
146
154
|
fs.rmSync(work, { recursive: true, force: true })
|
|
147
155
|
}
|
|
148
156
|
}
|
|
157
|
+
if (how.kind === 'win') {
|
|
158
|
+
const work = path.dirname(file)
|
|
159
|
+
// `tar` de Windows (bsdtar, desde Windows 10) desempaqueta un .zip.
|
|
160
|
+
try { run('tar', ['-xf', file, '-C', work], { stdio: ['ignore', 'ignore', 'pipe'] }) } catch (e) {
|
|
161
|
+
return fail('unpack-failed', `could not unpack the release: ${String(e.stderr || e.message).trim()}`, { file })
|
|
162
|
+
}
|
|
163
|
+
const name = `${BINARY}.exe`
|
|
164
|
+
const src = [path.join(work, name), ...fs.readdirSync(work).map((d) => path.join(work, d, name))].find((f) => fs.existsSync(f))
|
|
165
|
+
if (!src) return fail('bad-zip', `the zip has no ${name} inside`, { file })
|
|
166
|
+
// El .exe que corre no se puede pisar, pero sí apartar: la ventana abierta sigue con él. El
|
|
167
|
+
// `.old` de la vez anterior se borra si ya nadie lo usa.
|
|
168
|
+
const old = `${exe}.old`
|
|
169
|
+
try { fs.rmSync(old, { force: true }) } catch (_) { /* aún lo usa una ventana: se queda */ }
|
|
170
|
+
try {
|
|
171
|
+
fs.renameSync(exe, old)
|
|
172
|
+
try { fs.copyFileSync(src, exe) } catch (e) { fs.renameSync(old, exe); throw e }
|
|
173
|
+
} catch (e) {
|
|
174
|
+
return fail('install-failed', `could not replace the app: ${e.message}`, { file })
|
|
175
|
+
}
|
|
176
|
+
return { ok: true }
|
|
177
|
+
}
|
|
149
178
|
return fail('unknown-kind', `unknown install kind: ${how.kind}`)
|
|
150
179
|
}
|
|
151
180
|
|
package/local.js
CHANGED
|
@@ -19,6 +19,10 @@
|
|
|
19
19
|
* hacerse pasar por él, porque no sabe cómo se va a llamar;
|
|
20
20
|
* · una LLAVE que la ventana manda en su primera línea. La lista de tuberías la ve cualquiera,
|
|
21
21
|
* y sin la llave el agente corta la conexión sin atender nada.
|
|
22
|
+
*
|
|
23
|
+
* Por eso la tubería se abre para todos (`readableAll`/`writableAll`): lo que protege es la llave.
|
|
24
|
+
* Con el permiso por defecto, un agente lanzado con el token de administrador entero (desde SSH)
|
|
25
|
+
* dejaba fuera a las ventanas del mismo usuario, que corren sin elevar.
|
|
22
26
|
*/
|
|
23
27
|
import fs from 'node:fs'
|
|
24
28
|
import net from 'node:net'
|
|
@@ -137,7 +141,7 @@ export async function listenLocal ({ dir, serve, platform = process.platform })
|
|
|
137
141
|
})
|
|
138
142
|
await new Promise((resolve, reject) => {
|
|
139
143
|
server.once('error', reject)
|
|
140
|
-
server.listen(file, () => { server.off('error', reject); resolve() })
|
|
144
|
+
server.listen({ path: file, ...(key ? { readableAll: true, writableAll: true } : {}) }, () => { server.off('error', reject); resolve() })
|
|
141
145
|
})
|
|
142
146
|
if (key) {
|
|
143
147
|
// Se apunta DESPUÉS de escuchar: quien lo lea encuentra la tubería ya abierta.
|
|
@@ -190,7 +194,10 @@ export function connectLocal (dir, { platform = process.platform } = {}) {
|
|
|
190
194
|
})
|
|
191
195
|
// Tras conectar, un error acaba en 'close', que ya se avisa arriba.
|
|
192
196
|
sock.on('error', (e) => {
|
|
193
|
-
if (
|
|
197
|
+
if (connected) return
|
|
198
|
+
// Hay agente pero no deja entrar: no es lo mismo que no haber ninguno.
|
|
199
|
+
if (e.code === 'EPERM' || e.code === 'EACCES') reject(Object.assign(new Error(`the terminal agent on ${file} refused this window (${e.code})`), { code: 'EAGENTACCESS', cause: e }))
|
|
200
|
+
else reject(Object.assign(new Error(`no terminal agent is listening on ${file}`), { code: 'ENOAGENT', cause: e }))
|
|
194
201
|
})
|
|
195
202
|
})
|
|
196
203
|
}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@dotrino/terminal-agent",
|
|
3
|
-
"version": "0.47.
|
|
3
|
+
"version": "0.47.2",
|
|
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": {
|
package/service.js
CHANGED
|
@@ -129,9 +129,24 @@ const alive = (pid) => { try { process.kill(pid, 0); return true } catch (e) { r
|
|
|
129
129
|
const runKeyFile = (name) => `${RUN_KEY}\\${runValue(name)}`
|
|
130
130
|
const hasRunKey = (name, run) => quiet(run, 'reg', ['query', RUN_KEY, '/v', runValue(name)]).ok
|
|
131
131
|
|
|
132
|
-
/**
|
|
133
|
-
|
|
134
|
-
|
|
132
|
+
/** PowerShell: una cadena entre comillas simples. */
|
|
133
|
+
const psQuote = (s) => `'${String(s).replace(/'/g, "''")}'`
|
|
134
|
+
|
|
135
|
+
/**
|
|
136
|
+
* Windows: lanza el supervisor del perfil, ya sin ventana.
|
|
137
|
+
*
|
|
138
|
+
* Desde una sesión SSH no vale un proceso aparte: sshd mete la sesión en un objeto de trabajo y
|
|
139
|
+
* al cerrarla mata todo lo que lanzó, y Node no puede pedir salirse de él. Ahí lo crea WMI
|
|
140
|
+
* (`Win32_Process.Create`), que lo lanza fuera de la sesión, y con la misma línea que queda en
|
|
141
|
+
* `HKCU\…\Run`: así se prueba también la que correrá al iniciar sesión.
|
|
142
|
+
*/
|
|
143
|
+
function spawnSupervisor ({ name, node, cli, spawn, run, env }) {
|
|
144
|
+
if (env.SSH_CONNECTION || env.SSH_CLIENT) {
|
|
145
|
+
const script = `$r = Invoke-CimMethod -ClassName Win32_Process -MethodName Create -Arguments @{ CommandLine = ${psQuote(runCommand({ name, node, cli }))} }; if ($r.ReturnValue -ne 0) { throw "Win32_Process.Create returned $($r.ReturnValue)" }`
|
|
146
|
+
must(run, 'powershell.exe', ['-NoProfile', '-NonInteractive', '-Command', script])
|
|
147
|
+
return
|
|
148
|
+
}
|
|
149
|
+
const child = spawn(node, [cli, 'supervise', '--name', name], { detached: true, windowsHide: true, stdio: 'ignore', env: { ...env, DOTRINO_SUPERVISOR: '1' } })
|
|
135
150
|
child.unref()
|
|
136
151
|
}
|
|
137
152
|
|
|
@@ -182,12 +197,12 @@ function stopSupervised (dir) {
|
|
|
182
197
|
*
|
|
183
198
|
* @returns {{ kind:'systemd'|'launchd'|'run-key', file:string, started:boolean, boot?:boolean, lingerReason?:string }}
|
|
184
199
|
*/
|
|
185
|
-
export function installService ({ name, node = process.execPath, cli, dir, running = false, pathEnv = process.env.PATH || '', platform = process.platform, home = os.homedir(), user = os.userInfo().username, uid = process.getuid?.(), run = execFileSync, spawn = childSpawn }) {
|
|
200
|
+
export function installService ({ name, node = process.execPath, cli, dir, running = false, pathEnv = process.env.PATH || '', platform = process.platform, home = os.homedir(), user = os.userInfo().username, uid = process.getuid?.(), run = execFileSync, spawn = childSpawn, env = process.env }) {
|
|
186
201
|
const kind = platformOf({ platform, run })
|
|
187
202
|
if (kind === 'run-key') {
|
|
188
203
|
must(run, 'reg', ['add', RUN_KEY, '/v', runValue(name), '/t', 'REG_SZ', '/d', runCommand({ name, node, cli }), '/f'])
|
|
189
204
|
if (running) return { kind, file: runKeyFile(name), started: false }
|
|
190
|
-
spawnSupervisor({ name, node, cli, spawn })
|
|
205
|
+
spawnSupervisor({ name, node, cli, spawn, run, env })
|
|
191
206
|
return { kind, file: runKeyFile(name), started: true }
|
|
192
207
|
}
|
|
193
208
|
if (kind === 'launchd') {
|
|
@@ -219,11 +234,11 @@ export function installService ({ name, node = process.execPath, cli, dir, runni
|
|
|
219
234
|
* `dotrino-terminal` cuando no encuentra agente, para no levantar uno propio al lado de un
|
|
220
235
|
* servicio que el sistema arrancaría después con la misma llave.
|
|
221
236
|
*/
|
|
222
|
-
export function startService ({ name, dir, node = process.execPath, cli, platform = process.platform, home = os.homedir(), uid = process.getuid?.(), run = execFileSync, spawn = childSpawn }) {
|
|
237
|
+
export function startService ({ name, dir, node = process.execPath, cli, platform = process.platform, home = os.homedir(), uid = process.getuid?.(), run = execFileSync, spawn = childSpawn, env = process.env }) {
|
|
223
238
|
if (platform === 'win32') {
|
|
224
239
|
if (!hasRunKey(name, run)) return false
|
|
225
240
|
const pid = readPid(supervisorPidFile(dir))
|
|
226
|
-
if (!(pid && alive(pid))) spawnSupervisor({ name, node, cli, spawn })
|
|
241
|
+
if (!(pid && alive(pid))) spawnSupervisor({ name, node, cli, spawn, run, env })
|
|
227
242
|
return true
|
|
228
243
|
}
|
|
229
244
|
if (platform === 'darwin') {
|