@dotrino/terminal-agent 0.36.0 → 0.37.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 +5 -0
- package/bin/terminal.js +22 -4
- package/consoles.js +13 -1
- package/index.js +4 -2
- package/package.json +1 -1
- package/skills/dotrino-terminal-note/SKILL.md +44 -29
package/README.md
CHANGED
|
@@ -94,8 +94,13 @@ dotrino-terminal note # la enseña
|
|
|
94
94
|
dotrino-terminal note "texto" # la reemplaza («-» la lee de la entrada estándar)
|
|
95
95
|
dotrino-terminal note --add "línea" # le añade una línea
|
|
96
96
|
dotrino-terminal note --clear # la borra
|
|
97
|
+
dotrino-terminal note --task "tarea" # la TAREA en curso, que va aparte de la nota
|
|
97
98
|
```
|
|
98
99
|
|
|
100
|
+
Son dos campos: la **nota** es de la persona (la edita desde la tarjeta) y la **tarea** es del
|
|
101
|
+
programa que corre dentro (`--task`). En la tarjeta la tarea se ve y se quita, no se edita; y
|
|
102
|
+
`--task` no puede tocar la nota.
|
|
103
|
+
|
|
99
104
|
Sin `--id`, es la consola en la que corre la orden: el agente pone su id en
|
|
100
105
|
`DOTRINO_TERMINAL_CONSOLE`. Vive en memoria, como la consola: se va con ella. Hasta 4000 caracteres.
|
|
101
106
|
|
package/bin/terminal.js
CHANGED
|
@@ -60,6 +60,8 @@ if (args.includes('-h') || args.includes('--help')) {
|
|
|
60
60
|
dotrino-terminal note <texto> la reemplaza («-» la lee de la entrada estándar)
|
|
61
61
|
dotrino-terminal note --add <texto> le añade una línea
|
|
62
62
|
dotrino-terminal note --clear la borra
|
|
63
|
+
dotrino-terminal note --task <texto> pone la TAREA en curso, que va aparte de la nota: es
|
|
64
|
+
lo que usa un programa; --task '' la quita
|
|
63
65
|
(--id <id> para otra consola; --json para leerla una máquina)
|
|
64
66
|
dotrino-terminal profiles [--json] los perfiles de esta máquina
|
|
65
67
|
dotrino-terminal link [--name <n>] enlaza un perfil con tu bóveda
|
|
@@ -84,6 +86,8 @@ Cerrar la ventana no cierra la consola: sigue abierta y se retoma después.`, `u
|
|
|
84
86
|
dotrino-terminal note <text> replace it ("-" reads it from standard input)
|
|
85
87
|
dotrino-terminal note --add <text> append a line
|
|
86
88
|
dotrino-terminal note --clear clear it
|
|
89
|
+
dotrino-terminal note --task <text> set the TASK in progress, kept apart from the note: what
|
|
90
|
+
a program uses; --task '' removes it
|
|
87
91
|
(--id <id> for another console; --json for a machine to read)
|
|
88
92
|
dotrino-terminal profiles [--json] this machine's profiles
|
|
89
93
|
dotrino-terminal link [--name <n>] link a profile with your vault
|
|
@@ -388,12 +392,15 @@ async function list (conn) {
|
|
|
388
392
|
* agente pone su id en `DOTRINO_TERMINAL_CONSOLE`), que es como la cambia un programa desde dentro.
|
|
389
393
|
* No levanta ningún agente: sin agente no hay consola a la que ponerle nota.
|
|
390
394
|
*/
|
|
395
|
+
/** Cómo se enseñan, al leer la nota, las líneas de la tarea (la que pone un programa con `note --task`). */
|
|
396
|
+
const TASK_MARK = '▸ '
|
|
397
|
+
|
|
391
398
|
async function note () {
|
|
392
399
|
const id = opt('--id') || process.env.DOTRINO_TERMINAL_CONSOLE
|
|
393
400
|
if (!id) die(t('no sé de qué consola: esta shell no corre dentro de Dotrino Terminal. Usa --id <id> (mira «dotrino-terminal ls»).', 'no console to act on: this shell is not running inside Dotrino Terminal. Use --id <id> (see "dotrino-terminal ls").'))
|
|
394
401
|
// Dentro de una consola, el perfil es el de esa consola, no el `default`.
|
|
395
402
|
const dir = opt('--dir') || (opt('--name') ? dataDir(opt('--name')) : process.env.DOTRINO_TERMINAL_PROFILE_DIR || dataDir())
|
|
396
|
-
const valued = new Set(['--id', '--dir', '--name', '--add'])
|
|
403
|
+
const valued = new Set(['--id', '--dir', '--name', '--add', '--task'])
|
|
397
404
|
const words = []
|
|
398
405
|
for (let i = 1; i < args.length; i++) {
|
|
399
406
|
if (valued.has(args[i])) { i++; continue }
|
|
@@ -402,6 +409,7 @@ async function note () {
|
|
|
402
409
|
const stdin = () => fs.readFileSync(0, 'utf8').replace(/\n+$/, '')
|
|
403
410
|
const given = words.length ? (words.length === 1 && words[0] === '-' ? stdin() : words.join(' ')) : null
|
|
404
411
|
const add = opt('--add') === '-' ? stdin() : opt('--add')
|
|
412
|
+
const task = opt('--task') === '-' ? stdin() : opt('--task')
|
|
405
413
|
let conn
|
|
406
414
|
try { conn = await connectLocal(dir) } catch (e) {
|
|
407
415
|
if (e.code !== 'ENOAGENT') throw e
|
|
@@ -415,15 +423,25 @@ async function note () {
|
|
|
415
423
|
return r.console
|
|
416
424
|
}
|
|
417
425
|
let c
|
|
418
|
-
if (
|
|
426
|
+
if (task !== undefined) {
|
|
427
|
+
// LA TAREA ES DEL PROGRAMA, LA NOTA ES DE LA PERSONA: dos campos. Esta orden solo escribe el
|
|
428
|
+
// primero, así un agente de IA no puede pisar una nota personal ni por descuido.
|
|
429
|
+
c = await ask({ type: 'note', id, task: task.split('\n').map((l) => l.trim()).filter(Boolean).join('\n') })
|
|
430
|
+
// Un agente anterior a la 0.37 contesta, pero no guarda tareas: se dice, no se da por hecha.
|
|
431
|
+
if (c.task === undefined) die(t('el agente que corre es anterior a la 0.37.0 y no guarda tareas. Reinícialo con la versión nueva (cierra sus consolas).', 'the running agent predates 0.37.0 and keeps no tasks. Restart it with the new version (closes its consoles).'))
|
|
432
|
+
} else if (args.includes('--clear')) c = await ask({ type: 'note', id, text: '' })
|
|
419
433
|
else if (add !== undefined) {
|
|
420
434
|
const before = (await ask({ type: 'note', id })).note || ''
|
|
421
435
|
c = await ask({ type: 'note', id, text: before ? `${before}\n${add}` : add })
|
|
422
436
|
} else if (given !== null) c = await ask({ type: 'note', id, text: given })
|
|
423
437
|
else c = await ask({ type: 'note', id })
|
|
424
438
|
conn.close()
|
|
425
|
-
if (args.includes('--json')) console.log(JSON.stringify({ id: c.id, n: c.n, title: c.title, note: c.note }, null, 2))
|
|
426
|
-
else
|
|
439
|
+
if (args.includes('--json')) console.log(JSON.stringify({ id: c.id, n: c.n, title: c.title, task: c.task || '', note: c.note }, null, 2))
|
|
440
|
+
else {
|
|
441
|
+
// La tarea, marcada; debajo, la nota de la persona.
|
|
442
|
+
const lines = [...(c.task ? c.task.split('\n').map((l) => TASK_MARK + l) : []), ...(c.note ? [c.note] : [])]
|
|
443
|
+
if (lines.length) console.log(lines.join('\n'))
|
|
444
|
+
}
|
|
427
445
|
}
|
|
428
446
|
|
|
429
447
|
/** La ventana: la TTY enganchada a una consola del agente. */
|
package/consoles.js
CHANGED
|
@@ -83,6 +83,10 @@ class Console {
|
|
|
83
83
|
// DE QUÉ VA esta consola: una nota libre que escribe la persona desde cualquier pantalla, o el
|
|
84
84
|
// programa que corre dentro (`dotrino-terminal note`). En memoria, como todo lo de la consola.
|
|
85
85
|
this.note = ''
|
|
86
|
+
// LA TAREA EN CURSO, aparte de la nota: la pone el programa que corre dentro
|
|
87
|
+
// (`dotrino-terminal note --task`). Son dos campos para que un agente de IA no pueda pisar lo
|
|
88
|
+
// que escribió la persona, ni la persona tenga que editar lo del agente: solo lo quita.
|
|
89
|
+
this.task = ''
|
|
86
90
|
this.cols = cols
|
|
87
91
|
this.rows = rows
|
|
88
92
|
this.createdAt = Date.now()
|
|
@@ -152,6 +156,14 @@ class Console {
|
|
|
152
156
|
this._meta()
|
|
153
157
|
}
|
|
154
158
|
|
|
159
|
+
/** Cambia la tarea en curso (la del programa). No toca la nota de la persona. */
|
|
160
|
+
setTask (text) {
|
|
161
|
+
const task = String(text ?? '').slice(0, NOTE_MAX)
|
|
162
|
+
if (task === this.task) return
|
|
163
|
+
this.task = task
|
|
164
|
+
this._meta()
|
|
165
|
+
}
|
|
166
|
+
|
|
155
167
|
/** Avisa a todos los que miran de que cambió quién mira, el título o la nota. */
|
|
156
168
|
_meta () {
|
|
157
169
|
const info = this.info()
|
|
@@ -263,7 +275,7 @@ class Console {
|
|
|
263
275
|
const watchers = [...this.viewers].filter((v) => v.origin).map((v) => ({ origin: v.origin, device: v.device || null, tag: v.tag || null }))
|
|
264
276
|
const d = this.holder
|
|
265
277
|
const sizeBy = d ? { origin: d.origin || null, device: d.device || null, tag: d.tag || null } : null
|
|
266
|
-
return { id: this.id, n: this.n, activity: this.busy ? 'busy' : 'idle', doneAt: this.doneAt, sizeBy, origin: this.origin, title: this.title, note: this.note, host: HOST, cwd: cwdOf(this.pty?.pid), cols: this.cols, rows: this.rows, createdAt: this.createdAt, lastActive: this.lastActive, viewers: this.viewers.size, watchers }
|
|
278
|
+
return { id: this.id, n: this.n, activity: this.busy ? 'busy' : 'idle', doneAt: this.doneAt, sizeBy, origin: this.origin, title: this.title, note: this.note, task: this.task, host: HOST, cwd: cwdOf(this.pty?.pid), cols: this.cols, rows: this.rows, createdAt: this.createdAt, lastActive: this.lastActive, viewers: this.viewers.size, watchers }
|
|
267
279
|
}
|
|
268
280
|
}
|
|
269
281
|
|
package/index.js
CHANGED
|
@@ -15,8 +15,9 @@
|
|
|
15
15
|
* { type:'input', data } · { type:'resize', cols, rows } · { type:'take' } ·
|
|
16
16
|
* { type:'close' } (mata la consola enganchada) · { type:'kill', id } ·
|
|
17
17
|
* { type:'move', id, before? } (el orden del panel; contesta con `consoles`) ·
|
|
18
|
-
* { type:'note', id?, text? } (
|
|
19
|
-
*
|
|
18
|
+
* { type:'note', id?, text?, task? } (de qué va una consola: `text` es la nota de
|
|
19
|
+
* la persona y `task` la tarea que pone el programa; sin `id`, la enganchada;
|
|
20
|
+
* sin ninguno de los dos, solo lee; contesta con `noted`) ·
|
|
20
21
|
* { type:'unlock', code } (la clave de la máquina, si tiene: access.js)
|
|
21
22
|
* agente → cliente: { type:'consoles', list } · { type:'attached', id, fresh } ·
|
|
22
23
|
* { type:'replay', id, data, last } · { type:'out', data } ·
|
|
@@ -211,6 +212,7 @@ export function serveSession (session, hub, { origin = 'remote', gate = null } =
|
|
|
211
212
|
const c = msg.id == null ? current : hub.get(String(msg.id))
|
|
212
213
|
if (!c) return fail('no-console', 'that console no longer exists')
|
|
213
214
|
if (typeof msg.text === 'string') c.setNote(msg.text)
|
|
215
|
+
if (typeof msg.task === 'string') c.setTask(msg.task)
|
|
214
216
|
session.send({ type: 'noted', console: c.info() })
|
|
215
217
|
return
|
|
216
218
|
}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@dotrino/terminal-agent",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.37.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": {
|
|
@@ -1,57 +1,72 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: dotrino-terminal-note
|
|
3
|
-
description: Mantiene al día la tarjeta «de qué va» de la consola de Dotrino Terminal en la que corres (la ve el dueño flotando sobre la consola, en todas sus pantallas). Úsalo AL EMPEZAR cada tarea, cuando la tarea cambia de rumbo, y al terminar o quedar esperando al usuario, siempre que exista la variable de entorno DOTRINO_TERMINAL_CONSOLE. También cuando el usuario diga «nota de la consola», «el flotante», «la tarjeta
|
|
3
|
+
description: Mantiene al día la tarea en curso en la tarjeta «de qué va» de la consola de Dotrino Terminal en la que corres (la ve el dueño flotando sobre la consola, en todas sus pantallas). Úsalo AL EMPEZAR cada tarea, cuando la tarea cambia de rumbo, y al terminar o quedar esperando al usuario, siempre que exista la variable de entorno DOTRINO_TERMINAL_CONSOLE. También cuando el usuario diga «nota de la consola», «el flotante», «la tarjeta» o «de qué va este chat». Orden: `dotrino-terminal note --task`. Las notas personales del dueño NO se tocan.
|
|
4
4
|
---
|
|
5
5
|
|
|
6
|
-
# La
|
|
6
|
+
# La tarea en curso de la consola (Dotrino Terminal)
|
|
7
7
|
|
|
8
|
-
Cada consola de Dotrino Terminal tiene una **nota
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
|
|
8
|
+
Cada consola de Dotrino Terminal tiene una **nota** que sale en una tarjeta flotante sobre la
|
|
9
|
+
consola y, su primera línea, en la lista de consolas. Existe para que el dueño, con varias consolas
|
|
10
|
+
abiertas, sepa **de qué va la tarea en curso de cada una** sin entrar a leerla.
|
|
11
|
+
|
|
12
|
+
La tarjeta tiene dos partes, y son dos campos distintos:
|
|
13
|
+
|
|
14
|
+
- **La tarea**: es TUYA. La pones con `--task`. El dueño la ve y puede quitarla, no la edita.
|
|
15
|
+
- **Las notas**: son **personales del dueño**. Las escribe él desde la tarjeta. No son tuyas.
|
|
16
|
+
|
|
17
|
+
## Regla dura: las notas personales no se tocan
|
|
18
|
+
|
|
19
|
+
**Usa SOLO `dotrino-terminal note --task`.** Esa orden escribe la tarea y no puede tocar las notas
|
|
20
|
+
del dueño.
|
|
21
|
+
|
|
22
|
+
**Prohibido**, salvo que el usuario te lo pida con esas palabras en ese momento:
|
|
23
|
+
|
|
24
|
+
- `dotrino-terminal note "texto"` y `dotrino-terminal note -` (reemplazan SUS notas)
|
|
25
|
+
- `dotrino-terminal note --add …` (escribe en sus notas como si fueras él)
|
|
26
|
+
- `dotrino-terminal note --clear` (borra sus notas)
|
|
27
|
+
|
|
28
|
+
No reescribas, ordenes, corrijas ni resumas lo que él escribió. Tampoco lo copies a tus líneas.
|
|
12
29
|
|
|
13
30
|
## Cuándo
|
|
14
31
|
|
|
15
32
|
1. Comprueba que corres dentro de una consola: `echo "$DOTRINO_TERMINAL_CONSOLE"`. Vacío = no hay
|
|
16
33
|
consola ni tarjeta: no hagas nada y no lo menciones.
|
|
17
|
-
2. **Al empezar una tarea**:
|
|
18
|
-
3. **Cuando cambia** (otra tarea, otro rumbo, un bloqueo):
|
|
19
|
-
4. **Al terminar o al quedar esperando al usuario**:
|
|
34
|
+
2. **Al empezar una tarea**: pon la tarea.
|
|
35
|
+
3. **Cuando cambia** (otra tarea, otro rumbo, un bloqueo): vuelve a ponerla.
|
|
36
|
+
4. **Al terminar o al quedar esperando al usuario**: dilo en la primera línea.
|
|
20
37
|
|
|
21
38
|
Una orden por momento, sin anunciarlo ni comentarlo en la respuesta.
|
|
22
39
|
|
|
23
40
|
## Cómo
|
|
24
41
|
|
|
25
42
|
```bash
|
|
26
|
-
dotrino-terminal note
|
|
27
|
-
|
|
28
|
-
dotrino-terminal note - <<'
|
|
43
|
+
dotrino-terminal note --task "Arreglando el login de facturero"
|
|
44
|
+
|
|
45
|
+
dotrino-terminal note --task - <<'EOF_TASK' # varias líneas, por la entrada estándar
|
|
29
46
|
Arreglando el login de facturero
|
|
30
47
|
Falta: probar con firma real
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
dotrino-terminal note --
|
|
34
|
-
dotrino-terminal note
|
|
48
|
+
EOF_TASK
|
|
49
|
+
|
|
50
|
+
dotrino-terminal note --task '' # quita tu tarea (lo del dueño se queda)
|
|
51
|
+
dotrino-terminal note # solo LEER: tu tarea (con «▸ ») y debajo sus notas
|
|
35
52
|
```
|
|
36
53
|
|
|
37
|
-
No hace falta decir qué consola: es la tuya.
|
|
54
|
+
No hace falta decir qué consola: es la tuya.
|
|
38
55
|
|
|
39
56
|
## Qué escribir
|
|
40
57
|
|
|
41
|
-
- **Primera línea = la tarea, en una frase corta** (hasta ~60 caracteres): es lo
|
|
42
|
-
|
|
43
|
-
- Debajo, solo lo que ayuda a retomar:
|
|
44
|
-
|
|
58
|
+
- **Primera línea = la tarea, en una frase corta** (hasta ~60 caracteres): es lo que se ve en la
|
|
59
|
+
lista. «Tarjeta de notas en dotrino-terminal», no «Trabajando en lo que pidió el usuario».
|
|
60
|
+
- Debajo, solo lo que ayuda a retomar: `Hecho:` / `Falta:` / `Espera: tu visto bueno`. Tres o
|
|
61
|
+
cuatro líneas en total.
|
|
45
62
|
- En el idioma del usuario. Sin secretos, llaves ni rutas con credenciales: la nota la ven todos
|
|
46
63
|
los aparatos de la cuenta.
|
|
47
|
-
-
|
|
48
|
-
consérvalas (reescribe las tuyas y deja las suyas, o usa `--add`). No la borres al terminar: di
|
|
49
|
-
que terminó.
|
|
64
|
+
- Al terminar no la quites: di que terminó (`Terminado: …`).
|
|
50
65
|
|
|
51
66
|
## Si falla
|
|
52
67
|
|
|
53
|
-
-
|
|
54
|
-
- «el agente
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
- **Nunca reinicies
|
|
68
|
+
- «no sé de qué consola» / `no console to act on`: no corres dentro de Dotrino Terminal. Sigue sin nota.
|
|
69
|
+
- «el agente que corre es anterior a la 0.37.0 y no guarda tareas», o «el agente no contestó»:
|
|
70
|
+
el agente de esta máquina es viejo. **No uses las otras formas como sustituto**: díselo al
|
|
71
|
+
usuario una vez (`npm i -g @dotrino/terminal-agent@latest` y reiniciarlo él) y sigue sin tarea.
|
|
72
|
+
- **Nunca reinicies el agente tú**: corres dentro de él y reiniciarlo cierra esta consola.
|