@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 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. Si un aparato remoto entra en una ventana local, esa ventana suena y lo dice en el
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, otro Ctrl+] manda uno literal, y cualquier
337
- // otra tecla pasa tal cual, con su Ctrl+] delante. Las dos teclas pueden llegar juntas.
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). Es lo que deja a la ventana local avisar de que alguien entró desde fuera.
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.9.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": {