@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 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 (args.includes('--clear')) c = await ask({ type: 'note', id, text: '' })
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 if (c.note) console.log(c.note)
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? } (la nota de una consola: sin `id`, la enganchada;
19
- * sin `text`, solo la lee; contesta con `noted`) ·
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.36.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», «de qué va este chat» o pida anotar algo en la consola. Orden: `dotrino-terminal note`.
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 nota de la consola (Dotrino Terminal)
6
+ # La tarea en curso de la consola (Dotrino Terminal)
7
7
 
8
- Cada consola de Dotrino Terminal tiene una **nota**: texto libre que sale en una tarjeta flotante
9
- sobre la consola y, su primera línea, en la lista de consolas. Existe para que el dueño, con varias
10
- consolas abiertas, sepa **de qué va la tarea en curso de cada una** sin entrar a leerla. La escribes
11
- tú y también la edita él a mano: es de los dos.
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**: escribe la nota.
18
- 3. **Cuando cambia** (otra tarea, otro rumbo, un bloqueo): reescríbela.
19
- 4. **Al terminar o al quedar esperando al usuario**: déjalo dicho en la primera línea.
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 # la enseña (léela ANTES de reemplazarla)
27
- dotrino-terminal note "texto" # la reemplaza
28
- dotrino-terminal note - <<'EOF_NOTE' # varias líneas, por la entrada estándar
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
- EOF_NOTE
32
- dotrino-terminal note --add "línea" # le añade una línea al final
33
- dotrino-terminal note --clear # la borra
34
- dotrino-terminal note --json # { id, n, title, 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. `--id <id>` apunta a otra (`dotrino-terminal ls`).
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 único que se ve en
42
- la lista. «Tarjeta de notas en dotrino-terminal», no «Trabajando en lo que pidió el usuario».
43
- - Debajo, solo lo que ayuda a retomar: el estado (`Hecho:` / `Falta:` / `Espera: tu visto bueno`).
44
- Tres o cuatro líneas; el máximo son 4000 caracteres.
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
- - **Lo que escribió el dueño se respeta.** Lee la nota antes: si hay líneas que no son tuyas,
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
- - `no console to act on` / «no sé de qué consola»: no corres dentro de Dotrino Terminal. Sigue sin nota.
54
- - «el agente no contestó: es anterior a la 0.36.0»: el agente de esta máquina es viejo. Díselo al
55
- usuario una vez (se arregla con `npm i -g @dotrino/terminal-agent@latest` y reiniciándolo él:
56
- reiniciar el agente cierra sus consolas, **incluida esta**) y no lo reintentes en esa sesión.
57
- - **Nunca reinicies ni actualices el agente tú**: corres dentro de él.
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.