@dotrino/terminal-agent 0.3.1 → 0.4.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
@@ -9,8 +9,10 @@ añade el PTY.
9
9
  **Cómo se instala y se usa:** [wiki.dotrino.com/herramientas/terminal](https://wiki.dotrino.com/herramientas/terminal/).
10
10
 
11
11
  ```sh
12
- npx @dotrino/terminal-agent # enlaza (si falta) y corre
13
- npx @dotrino/terminal-agent enroll # re-enlaza y corre
12
+ npx @dotrino/terminal-agent # enlaza (si falta) y corre
13
+ npx @dotrino/terminal-agent enroll # re-enlaza y corre
14
+ npx @dotrino/terminal-agent --name casa # otro agente en la misma máquina, con su enlace
15
+ npx @dotrino/terminal-agent list # los enlazados aquí
14
16
  # [--proxy wss://…] [--shell /bin/zsh] [--dir /ruta]
15
17
  ```
16
18
 
@@ -26,7 +28,9 @@ const agent = await startAgent({ /* dir, proxyUrl, shell, quiet, onRevoked */ })
26
28
  // agent.machine · agent.machineId · agent.close()
27
29
  ```
28
30
 
29
- Datos en `~/.local/share/dotrino-terminal-agent` (override `DOTRINO_TERMINAL_DIR`). El
30
- `link.json` guarda la llave privada de la máquina: trátalo como una llave SSH.
31
+ Cada agente guarda su enlace en `~/.dotrino/agent/terminal-agent/<nombre>/`, el estándar de
32
+ `@dotrino/remote-agent/instances` (como `dotrino-env` en `~/.dotrino/service/`). Sin
33
+ `--name` se usa el único que haya, o `default`. `DOTRINO_TERMINAL_DIR` o `--dir` fuerzan una
34
+ carpeta concreta. El `link.json` guarda la llave privada: trátalo como una llave SSH.
31
35
 
32
36
  MIT.
package/bin/cli.js CHANGED
@@ -2,8 +2,11 @@
2
2
  /**
3
3
  * dotrino-terminal-agent — agente de Dotrino Terminal.
4
4
  *
5
- * dotrino-terminal-agent # enlaza (si falta) y CORRE el agente
6
- * dotrino-terminal-agent enroll # re-enlaza (sobrescribe) y corre el agente
5
+ * dotrino-terminal-agent [--name <n>] # enlaza (si falta) y CORRE el agente
6
+ * dotrino-terminal-agent enroll [--name <n>] # re-enlaza (sobrescribe) y corre el agente
7
+ * dotrino-terminal-agent list # los agentes enlazados en esta máquina
8
+ *
9
+ * Cada agente tiene su NOMBRE y su enlace (`@dotrino/remote-agent/instances`), como `dotrino-env`.
7
10
  *
8
11
  * El agente es un aparato más de tu cuenta: puede vivir en cualquier máquina. Con un
9
12
  * solo comando queda enlazado y aparece solo en terminal.dotrino.com.
@@ -12,7 +15,8 @@ import readline from 'node:readline'
12
15
  import { createRequire } from 'node:module'
13
16
  import { watchForUpdate } from '@dotrino/update'
14
17
  import { startAgent } from '../index.js'
15
- import { enroll, parseQr, loadLink, dataDir } from '../link.js'
18
+ import { enroll, parseQr, loadLink, dataDir, LABEL } from '../link.js'
19
+ import { listInstances, lockInstance, instancesRoot } from '@dotrino/remote-agent/instances'
16
20
 
17
21
  const { version: VERSION } = createRequire(import.meta.url)('../package.json')
18
22
  const args = process.argv.slice(2)
@@ -26,11 +30,20 @@ function ask (q) {
26
30
 
27
31
  if (args.includes('-h') || args.includes('--help')) {
28
32
  console.log(`uso:
29
- dotrino-terminal-agent enlaza esta máquina (si falta) y corre el agente
30
- dotrino-terminal-agent enroll re-enlaza (sobrescribe el enlace) y corre el agente
31
- opciones: [--proxy <wss://…>] [--shell <bin>] [--dir <ruta>]
33
+ dotrino-terminal-agent [--name <n>] enlaza este agente (si falta) y lo corre
34
+ dotrino-terminal-agent enroll [--name <n>] re-enlaza (sobrescribe el enlace) y lo corre
35
+ dotrino-terminal-agent list los agentes enlazados en esta máquina
36
+ opciones: [--name <n>] [--proxy <wss://…>] [--shell <bin>] [--dir <ruta>]
37
+
38
+ enlaces en ${instancesRoot(LABEL)}/<nombre> (override DOTRINO_AGENT_HOME;
39
+ --dir o DOTRINO_TERMINAL_DIR fuerzan una carpeta concreta)`)
40
+ process.exit(0)
41
+ }
32
42
 
33
- datos en ${dataDir()} (override DOTRINO_TERMINAL_DIR)`)
43
+ if (cmd === 'list') {
44
+ const names = listInstances(LABEL)
45
+ if (!names.length) console.log('No hay ningún agente de terminal enlazado en esta máquina.')
46
+ for (const n of names) console.log(` ${n} ${instancesRoot(LABEL)}/${n}`)
34
47
  process.exit(0)
35
48
  }
36
49
 
@@ -57,7 +70,9 @@ async function doEnroll (dir) {
57
70
  }
58
71
 
59
72
  try {
60
- const dir = opt('--dir')
73
+ const dir = opt('--dir') || dataDir(opt('--name'))
74
+ // Antes de nada, también de enlazar: dos procesos con el mismo enlace son la misma llave.
75
+ process.on('exit', lockInstance(dir))
61
76
  // Sin `enroll`, enlaza solo si aún no lo está; `enroll` re-enlaza aunque ya lo esté.
62
77
  // En los dos casos sigue y LEVANTA el servicio.
63
78
  if (cmd === 'enroll' || !loadLink(dir)) {
package/link.js CHANGED
@@ -1,22 +1,24 @@
1
1
  /**
2
2
  * link.js — el enlace de esta máquina con la bóveda. Todo lo hace
3
3
  * `@dotrino/remote-agent/link` (que a su vez usa `enrollWithVault`, el único
4
- * enrolamiento headless del ecosistema); aquí solo se decide DÓNDE vive el enlace.
4
+ * enrolamiento headless del ecosistema), y DÓNDE vive lo decide el estándar
5
+ * `@dotrino/remote-agent/instances`: `~/.dotrino/agent/terminal-agent/<nombre>/`.
5
6
  */
6
- import path from 'node:path'
7
- import os from 'node:os'
8
7
  import { enroll as raEnroll, loadLink as raLoad, parseQr } from '@dotrino/remote-agent/link'
8
+ import { resolveInstance } from '@dotrino/remote-agent/instances'
9
9
 
10
10
  export { parseQr }
11
11
 
12
- /** Label con el que se enrola y con el que la app encuentra las máquinas. */
12
+ /** El tipo de este agente: lo contesta al ping y da nombre a la carpeta de sus enlaces. */
13
13
  export const LABEL = 'terminal-agent'
14
14
 
15
- /** `~/.local/share/dotrino-terminal-agent` (override `DOTRINO_TERMINAL_DIR`). */
16
- export function dataDir () {
15
+ /**
16
+ * La carpeta del enlace. `DOTRINO_TERMINAL_DIR` fuerza una concreta (un contenedor); si no,
17
+ * la de la instancia `name` (sin nombre se busca y solo se exige con empate).
18
+ */
19
+ export function dataDir (name) {
17
20
  if (process.env.DOTRINO_TERMINAL_DIR) return process.env.DOTRINO_TERMINAL_DIR
18
- const base = process.env.XDG_DATA_HOME || path.join(os.homedir(), '.local', 'share')
19
- return path.join(base, 'dotrino-terminal-agent')
21
+ return resolveInstance(LABEL, name).dir
20
22
  }
21
23
 
22
24
  export const loadLink = (dir = dataDir()) => raLoad(dir)
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@dotrino/terminal-agent",
3
- "version": "0.3.1",
3
+ "version": "0.4.0",
4
4
  "description": "Agente de Dotrino Terminal: abre una shell (PTY) en esta máquina solo para los aparatos de tu cuenta, cifrada punto a punto, vía @dotrino/remote-agent.",
5
5
  "type": "module",
6
6
  "bin": {
@@ -22,7 +22,7 @@
22
22
  "dependencies": {
23
23
  "@dotrino/identity": "0.105.0",
24
24
  "@dotrino/proxy-client": "0.25.0",
25
- "@dotrino/remote-agent": "0.11.0",
25
+ "@dotrino/remote-agent": "0.12.0",
26
26
  "@dotrino/update": "0.2.2",
27
27
  "@dotrino/vault": "0.74.0",
28
28
  "@homebridge/node-pty-prebuilt-multiarch": "0.14.1-beta.2"