@dotrino/terminal-agent 0.9.0 → 0.11.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 +3 -1
- package/bin/terminal.js +41 -6
- package/consoles.js +3 -2
- package/index.js +5 -1
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -33,7 +33,9 @@ dotrino-terminal rename <perfil> [nuevo] # renombrarlo (mueve su carpeta y para
|
|
|
33
33
|
```
|
|
34
34
|
|
|
35
35
|
Cerrar la ventana cierra su consola, como cualquier terminal; **Ctrl+] y luego d** la suelta
|
|
36
|
-
viva
|
|
36
|
+
viva, **Ctrl+] n** abre otra (soltando la actual) y **Ctrl+] a<id> Enter** pasa a otra consola,
|
|
37
|
+
por la misma conexión, y **Ctrl+] r** ajusta la consola al tamaño de esta ventana (la app de
|
|
38
|
+
escritorio lo manda al ganar el foco). `--tag <t>` presenta la ventana en la lista de quién mira. Si un aparato remoto entra en una ventana local, esa ventana suena y lo dice en el
|
|
37
39
|
título. Sin enlace el agente atiende solo a las ventanas locales; al enlazarlo
|
|
38
40
|
(`dotrino-terminal link`) enciende la parte remota sin reiniciarse. La app de escritorio
|
|
39
41
|
(`desktop/` del repo) es una ventana nativa que corre este mismo cliente.
|
package/bin/terminal.js
CHANGED
|
@@ -54,7 +54,9 @@ if (args.includes('-h') || args.includes('--help')) {
|
|
|
54
54
|
dotrino-terminal link [--name <n>] enlaza un perfil con tu bóveda
|
|
55
55
|
dotrino-terminal rename <perfil> [nuevo] renombra un perfil (para su agente: cierra sus consolas)
|
|
56
56
|
|
|
57
|
-
Dentro de una consola: Ctrl+] y luego d la suelta sin cerrarla
|
|
57
|
+
Dentro de una consola: Ctrl+] y luego d la suelta sin cerrarla; Ctrl+] n abre otra
|
|
58
|
+
(y suelta la actual); Ctrl+] a <id> Enter pasa a esa consola; Ctrl+] r ajusta la consola al
|
|
59
|
+
tamaño de esta ventana.
|
|
58
60
|
Cerrar la ventana cierra la consola que abrió.`, `usage:
|
|
59
61
|
dotrino-terminal [--name <n>] [--cwd <dir>] open a new console in this window, in the current folder
|
|
60
62
|
dotrino-terminal attach <id> [--name <n>] attach to an open console
|
|
@@ -64,7 +66,9 @@ Cerrar la ventana cierra la consola que abrió.`, `usage:
|
|
|
64
66
|
dotrino-terminal link [--name <n>] link a profile with your vault
|
|
65
67
|
dotrino-terminal rename <profile> [new] rename a profile (stops its agent: closes its consoles)
|
|
66
68
|
|
|
67
|
-
Inside a console: Ctrl+] then d detaches without closing it
|
|
69
|
+
Inside a console: Ctrl+] then d detaches without closing it; Ctrl+] n opens another
|
|
70
|
+
(detaching the current one); Ctrl+] a <id> Enter switches to that console; Ctrl+] r fits the
|
|
71
|
+
console to this window's size.
|
|
68
72
|
Closing the window closes the console it opened.`))
|
|
69
73
|
process.exit(0)
|
|
70
74
|
}
|
|
@@ -131,6 +135,9 @@ async function agent (dir) {
|
|
|
131
135
|
throw new Error(t(`el agente no arrancó; mira ${log}`, `the agent did not start; see ${log}`))
|
|
132
136
|
}
|
|
133
137
|
|
|
138
|
+
/** `--tag <t>`: cómo se presenta esta ventana en la lista de quién mira (la app de escritorio). */
|
|
139
|
+
const tag = () => (opt('--tag') ? { tag: opt('--tag') } : {})
|
|
140
|
+
|
|
134
141
|
function alive (pid) {
|
|
135
142
|
try { process.kill(pid, 0); return true } catch (e) { return e.code === 'EPERM' }
|
|
136
143
|
}
|
|
@@ -332,11 +339,30 @@ function interactive (conn, first, dir) {
|
|
|
332
339
|
process.stdin.off('data', earlyTap)
|
|
333
340
|
const decoder = new StringDecoder('utf8')
|
|
334
341
|
let prefixed = false
|
|
342
|
+
let collecting = null // tras Ctrl+] a: el id de la consola, hasta Enter
|
|
343
|
+
// Cambiar de consola SIN salir: por la misma conexión, y con la pantalla en limpio para que la
|
|
344
|
+
// repetición de la otra consola no se pinte encima. Lo tecleado mientras tanto se guarda.
|
|
345
|
+
const switchTo = (msg) => {
|
|
346
|
+
ready = false
|
|
347
|
+
out.write('\x1bc') // RIS: pantalla, historial y modos, de cero
|
|
348
|
+
conn.send({ ...msg, ...size(), ...tag() })
|
|
349
|
+
}
|
|
335
350
|
const onKeys = (buf) => {
|
|
336
|
-
// Ctrl+] abre el atajo: «d» suelta la consola,
|
|
337
|
-
//
|
|
351
|
+
// Ctrl+] abre el atajo: «d» suelta la consola, «n» abre otra nueva, «a<id>⏎» pasa a esa
|
|
352
|
+
// consola (lo usa el panel de la app de escritorio), otro Ctrl+] manda uno literal, y
|
|
353
|
+
// cualquier otra tecla pasa tal cual, con su Ctrl+] delante. Pueden llegar todas juntas.
|
|
338
354
|
let send = ''
|
|
339
355
|
for (const ch of decoder.write(buf)) {
|
|
356
|
+
if (collecting !== null) {
|
|
357
|
+
if (ch === '\r' || ch === '\n') {
|
|
358
|
+
const id = collecting
|
|
359
|
+
collecting = null
|
|
360
|
+
if (send) { input(send); send = '' }
|
|
361
|
+
if (id) switchTo({ type: 'attach', id })
|
|
362
|
+
} else if (/[0-9a-f]/i.test(ch) && collecting.length < 64) collecting += ch
|
|
363
|
+
else collecting = null // no era un id: se descarta el atajo
|
|
364
|
+
continue
|
|
365
|
+
}
|
|
340
366
|
if (prefixed) {
|
|
341
367
|
prefixed = false
|
|
342
368
|
if (ch === 'd') {
|
|
@@ -344,6 +370,15 @@ function interactive (conn, first, dir) {
|
|
|
344
370
|
conn.send({ type: 'detach' })
|
|
345
371
|
return finish(0, t(`Consola soltada. Para volver: dotrino-terminal attach ${consoleId}`, `Console detached. To return: dotrino-terminal attach ${consoleId}`))
|
|
346
372
|
}
|
|
373
|
+
if (ch === 'a') { collecting = ''; continue }
|
|
374
|
+
// «r»: esta ventana manda en el tamaño de la consola (la app la usa al ganar el foco: con
|
|
375
|
+
// varias ventanas de tamaños distintos en la misma consola, se ajusta a la que miras).
|
|
376
|
+
if (ch === 'r') { conn.send({ type: 'resize', ...size() }); continue }
|
|
377
|
+
if (ch === 'n') {
|
|
378
|
+
if (send) { input(send); send = '' }
|
|
379
|
+
switchTo({ type: 'open', cwd: first.cwd || path.resolve(process.cwd()) })
|
|
380
|
+
continue
|
|
381
|
+
}
|
|
347
382
|
send += ch === DETACH_PREFIX ? ch : DETACH_PREFIX + ch
|
|
348
383
|
} else if (ch === DETACH_PREFIX) prefixed = true
|
|
349
384
|
else send += ch
|
|
@@ -375,10 +410,10 @@ try {
|
|
|
375
410
|
conn.close()
|
|
376
411
|
} else if (cmd === 'attach') {
|
|
377
412
|
if (!args[1]) die(t('falta el id: dotrino-terminal attach <id> (mira «dotrino-terminal ls»)', 'missing id: dotrino-terminal attach <id> (see "dotrino-terminal ls")'))
|
|
378
|
-
interactive(conn, { type: 'attach', id: args[1] }, dir)
|
|
413
|
+
interactive(conn, { type: 'attach', id: args[1], ...tag() }, dir)
|
|
379
414
|
} else if (cmd === 'open') {
|
|
380
415
|
// Como cualquier terminal: la consola abre en la carpeta donde estás (o en `--cwd`).
|
|
381
|
-
interactive(conn, { type: 'open', cwd: path.resolve(opt('--cwd') || process.cwd()) }, dir)
|
|
416
|
+
interactive(conn, { type: 'open', cwd: path.resolve(opt('--cwd') || process.cwd()), ...tag() }, dir)
|
|
382
417
|
} else die(t(`orden desconocida: ${cmd} (mira --help)`, `unknown command: ${cmd} (see --help)`))
|
|
383
418
|
} catch (e) {
|
|
384
419
|
if (e !== HOLD) { try { die(`dotrino-terminal: ${e.message}`) } catch (_) {} }
|
package/consoles.js
CHANGED
|
@@ -93,10 +93,11 @@ class Console {
|
|
|
93
93
|
|
|
94
94
|
/**
|
|
95
95
|
* `watchers` dice QUIÉN mira: una ventana de esta máquina o un aparato de la cuenta (con
|
|
96
|
-
* su pubkey)
|
|
96
|
+
* su pubkey), y la etiqueta con la que se presentó (`tag`): así una ventana de la app de
|
|
97
|
+
* escritorio reconoce, en la lista, cuál es la consola que está mostrando ella. Es lo que deja a la ventana local avisar de que alguien entró desde fuera.
|
|
97
98
|
*/
|
|
98
99
|
info () {
|
|
99
|
-
const watchers = [...this.viewers].filter((v) => v.origin).map((v) => ({ origin: v.origin, device: v.device || null }))
|
|
100
|
+
const watchers = [...this.viewers].filter((v) => v.origin).map((v) => ({ origin: v.origin, device: v.device || null, tag: v.tag || null }))
|
|
100
101
|
return { id: this.id, origin: this.origin, title: this.title, cols: this.cols, rows: this.rows, createdAt: this.createdAt, lastActive: this.lastActive, viewers: this.viewers.size, watchers }
|
|
101
102
|
}
|
|
102
103
|
}
|
package/index.js
CHANGED
|
@@ -10,7 +10,7 @@
|
|
|
10
10
|
* el navegador solo las suelta, y cualquier aparato de la cuenta puede volver a ellas.
|
|
11
11
|
*
|
|
12
12
|
* Payloads de dominio (van cifrados dentro de la sesión, el proxio no los ve):
|
|
13
|
-
* cliente → agente: { type:'list' } · { type:'open', cols, rows, cwd? } ·
|
|
13
|
+
* cliente → agente: { type:'list' } · { type:'open', cols, rows, cwd?, tag? } ·
|
|
14
14
|
* { type:'attach', id, cols, rows } · { type:'detach' } ·
|
|
15
15
|
* { type:'input', data } · { type:'resize', cols, rows } ·
|
|
16
16
|
* { type:'close' } (mata la consola enganchada) · { type:'kill', id }
|
|
@@ -91,6 +91,8 @@ export function serveSession (session, hub, { origin = 'remote' } = {}) {
|
|
|
91
91
|
const release = () => { if (current) { current.detach(viewer); current = null } }
|
|
92
92
|
const fail = (code, message) => session.send({ type: 'fail', code, message })
|
|
93
93
|
const takeSize = (msg) => { if (msg.cols && msg.rows) size = { cols: msg.cols, rows: msg.rows } }
|
|
94
|
+
// La etiqueta con la que se presenta quien mira (una ventana de la app de escritorio).
|
|
95
|
+
const takeTag = (msg) => { if (typeof msg.tag === 'string') viewer.tag = msg.tag.slice(0, 64) }
|
|
94
96
|
|
|
95
97
|
async function attachTo (c, { fresh }) {
|
|
96
98
|
release()
|
|
@@ -108,6 +110,7 @@ export function serveSession (session, hub, { origin = 'remote' } = {}) {
|
|
|
108
110
|
if (msg.type === 'list') { session.send({ type: 'consoles', list: hub.list() }); return }
|
|
109
111
|
if (msg.type === 'open') {
|
|
110
112
|
takeSize(msg)
|
|
113
|
+
takeTag(msg)
|
|
111
114
|
// `cwd`: dónde abre la shell (la carpeta de la ventana que la pide). Si no existe, se
|
|
112
115
|
// dice: abrir en otra carpeta sin avisar haría que un comando corra donde no toca.
|
|
113
116
|
if (msg.cwd != null && !isDir(msg.cwd)) return fail('bad-cwd', `not a directory: ${msg.cwd}`)
|
|
@@ -120,6 +123,7 @@ export function serveSession (session, hub, { origin = 'remote' } = {}) {
|
|
|
120
123
|
const c = hub.get(msg.id)
|
|
121
124
|
if (!c) return fail('no-console', 'that console no longer exists')
|
|
122
125
|
takeSize(msg)
|
|
126
|
+
takeTag(msg)
|
|
123
127
|
c.resize(size.cols, size.rows)
|
|
124
128
|
attachTo(c, { fresh: false })
|
|
125
129
|
return
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@dotrino/terminal-agent",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.11.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": {
|