@dotrino/terminal-agent 0.3.0 → 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 +8 -4
- package/bin/cli.js +23 -8
- package/link.js +10 -8
- package/package.json +2 -2
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
|
|
13
|
-
npx @dotrino/terminal-agent enroll
|
|
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
|
-
|
|
30
|
-
`
|
|
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
|
|
6
|
-
* dotrino-terminal-agent enroll
|
|
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
|
|
30
|
-
dotrino-terminal-agent enroll
|
|
31
|
-
|
|
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
|
-
|
|
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)
|
|
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
|
-
/**
|
|
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
|
-
/**
|
|
16
|
-
|
|
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
|
-
|
|
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
|
+
"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.
|
|
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"
|