@dotrino/terminal-agent 0.25.0 → 0.27.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.
Files changed (3) hide show
  1. package/consoles.js +48 -3
  2. package/index.js +11 -1
  3. package/package.json +1 -1
package/consoles.js CHANGED
@@ -40,6 +40,9 @@ const GAP_MS = 2000 // un hueco mayor que este corta la racha: eran cambi
40
40
  // Diez segundos: de sobra para un agente, y un comando que calle más se da por terminado pronto.
41
41
  export const QUIET_MS = Math.max(1, Number(process.env.DOTRINO_TERMINAL_IDLE_SECONDS) || 10) * 1000
42
42
  const MIN_TASK_MS = 3000 // menos que esto no fue «una tarea»: no se marca como terminada
43
+ // Cerrar una consola: SIGHUP al momento y, si la shell sigue viva, SIGTERM y luego SIGKILL.
44
+ export const KILL_TERM_MS = 1500
45
+ export const KILL_KILL_MS = 3000
43
46
 
44
47
  /**
45
48
  * La carpeta en la que está AHORA el proceso de una consola (la shell), con `~` por la carpeta
@@ -293,6 +296,8 @@ export class ConsoleHub {
293
296
  // Su NÚMERO: el libre más bajo, y no cambia mientras viva. Si se cierra la 1, la 2 sigue
294
297
  // siendo la 2 y la próxima nueva será la 1. Lo da el agente para que sea el mismo en todas
295
298
  // las ventanas y aparatos.
299
+ // Una consola ya cerrada (`kill`) no está en el mapa: su número queda libre en el acto, así la
300
+ // que se abre para reemplazarla (los clientes pasan a otra ANTES de matar la suya) lo hereda.
296
301
  const used = new Set([...this.consoles.values()].map((c) => c.n))
297
302
  let n = 1
298
303
  while (used.has(n)) n++
@@ -302,6 +307,7 @@ export class ConsoleHub {
302
307
  pty.onExit(({ exitCode }) => {
303
308
  c.exited = true
304
309
  clearTimeout(c._quiet)
310
+ for (const t of c._killTimers || []) clearTimeout(t)
305
311
  this.consoles.delete(id)
306
312
  // A cada pantalla se le dice si la consola la cerró OTRA (`byOther`): la shell que termina
307
313
  // sola, o la que cierra la propia pantalla, no lo es. Quien mira decide con eso si se va
@@ -310,21 +316,60 @@ export class ConsoleHub {
310
316
  c.viewers.clear()
311
317
  try { c.screen.dispose() } catch (_) {}
312
318
  })
313
- this.consoles.set(id, c)
319
+ // DÓNDE va en el panel: mientras nadie haya movido nada (están por número), en su sitio por
320
+ // número; si alguien las ordenó a mano, al final, para no deshacerle el orden.
321
+ const all = [...this.consoles.values()]
322
+ const byNumber = all.every((x, i) => i === 0 || all[i - 1].n < x.n)
323
+ const at = byNumber ? all.findIndex((x) => x.n > n) : -1
324
+ if (at === -1) all.push(c); else all.splice(at, 0, c)
325
+ this._order(all)
314
326
  return c
315
327
  }
316
328
 
329
+ _order (all) { this.consoles = new Map(all.map((c) => [c.id, c])) }
330
+
331
+ /**
332
+ * El ORDEN del panel, el mismo en todas las ventanas y aparatos: la consola `id` pasa a estar
333
+ * justo antes de `before` (o al final, con `null` o con una que ya no existe). No cambia su
334
+ * número, que es fijo. `false` si esa consola ya no existe.
335
+ */
336
+ move (id, before = null) {
337
+ const c = this.consoles.get(id)
338
+ if (!c) return false
339
+ if (before === id) return true
340
+ const all = [...this.consoles.values()].filter((x) => x !== c)
341
+ const at = before == null ? -1 : all.findIndex((x) => x.id === before)
342
+ if (at === -1) all.push(c); else all.splice(at, 0, c)
343
+ this._order(all)
344
+ return true
345
+ }
346
+
317
347
  get (id) { return this.consoles.get(id) || null }
318
348
 
319
- list () { return [...this.consoles.values()].map((c) => c.info()).sort((a, b) => a.n - b.n) }
349
+ /** Las consolas, en el orden del panel (por número hasta que alguien las mueve: `move`). */
350
+ list () { return [...this.consoles.values()].map((c) => c.info()) }
320
351
 
321
- /** Cierra una consola. `by`: la pantalla (viewer) que lo pide, para decirle a las DEMÁS que no fueron ellas. */
352
+ /**
353
+ * Cierra una consola. `by`: la pantalla (viewer) que lo pide, para decirle a las DEMÁS que no fueron ellas.
354
+ *
355
+ * Desde que se pide, la consola YA NO EXISTE para nadie (no se lista, no se puede volver a ella y
356
+ * su número queda libre), aunque la shell tarde un instante en morir: preguntar justo después
357
+ * la devolvía y el panel enseñaba una consola muerta. Y si la shell no se va con el SIGHUP de
358
+ * siempre (un `trap '' HUP`, un programa colgado), se insiste: SIGTERM, y después SIGKILL. Antes
359
+ * la × no hacía nada y la consola se quedaba en la lista para siempre.
360
+ */
322
361
  kill (id, by = null) {
323
362
  const c = this.consoles.get(id)
324
363
  if (!c) return false
325
364
  c.killed = true
326
365
  c.killedBy = by
366
+ this.consoles.delete(id)
327
367
  try { c.pty.kill() } catch (_) {}
368
+ c._killTimers = [['SIGTERM', KILL_TERM_MS], ['SIGKILL', KILL_KILL_MS]].map(([sig, ms]) => {
369
+ const t = setTimeout(() => { if (!c.exited) try { c.pty.kill(sig) } catch (_) {} }, ms)
370
+ t.unref?.()
371
+ return t
372
+ })
328
373
  return true
329
374
  }
330
375
 
package/index.js CHANGED
@@ -14,6 +14,7 @@
14
14
  * { type:'attach', id, cols, rows } · { type:'detach' } ·
15
15
  * { type:'input', data } · { type:'resize', cols, rows } · { type:'pin', on } ·
16
16
  * { type:'close' } (mata la consola enganchada) · { type:'kill', id } ·
17
+ * { type:'move', id, before? } (el orden del panel; contesta con `consoles`) ·
17
18
  * { type:'unlock', code } (la clave de la máquina, si tiene: access.js)
18
19
  * agente → cliente: { type:'consoles', list } · { type:'attached', id, fresh } ·
19
20
  * { type:'replay', id, data, last } · { type:'out', data } ·
@@ -121,6 +122,10 @@ export function serveSession (session, hub, { origin = 'remote', gate = null } =
121
122
  release()
122
123
  current = c
123
124
  const snapshot = await c.attach(viewer)
125
+ // Mientras se hacía la foto la sesión se fue, soltó la consola o pidió otra: esta ya no es la
126
+ // suya. Quedarse enganchado dejaba un mirón FANTASMA (la consola salía «abierta en otro
127
+ // aparato» sin nadie mirando, y nadie la elegía como libre).
128
+ if (current !== c) { c.detach(viewer); return }
124
129
  c.sizeFrom(viewer, { attaching: true })
125
130
  // La pantalla va en trozos: el proxio corta los mensajes a 1 MB.
126
131
  for (let i = 0; i < snapshot.length || i === 0; i += REPLAY_CHUNK) {
@@ -174,7 +179,12 @@ export function serveSession (session, hub, { origin = 'remote', gate = null } =
174
179
  // ⤢ «Esta pantalla manda en el tamaño» (on) o soltarlo (off).
175
180
  if (msg.type === 'pin') { current?.pin(viewer, !!msg.on); return }
176
181
  if (msg.type === 'close') { if (current) hub.kill(current.id, viewer); return }
177
- if (msg.type === 'kill') { if (!hub.kill(msg.id, viewer)) fail('no-console', 'that console no longer exists') }
182
+ if (msg.type === 'kill') { if (!hub.kill(msg.id, viewer)) fail('no-console', 'that console no longer exists'); return }
183
+ // El orden del panel: es de la máquina, así que lo ve igual cualquier pantalla.
184
+ if (msg.type === 'move') {
185
+ if (!hub.move(String(msg.id), msg.before == null ? null : String(msg.before))) return fail('no-console', 'that console no longer exists')
186
+ session.send({ type: 'consoles', list: hub.list() })
187
+ }
178
188
  })
179
189
  session.on('close', () => {
180
190
  const mine = owned && owned === current ? owned : null
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@dotrino/terminal-agent",
3
- "version": "0.25.0",
3
+ "version": "0.27.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": {