@dotrino/terminal-agent 0.35.0 → 0.36.1

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
@@ -83,6 +83,29 @@ carpeta concreta. El `link.json` guarda la llave privada: trátalo como una llav
83
83
 
84
84
  MIT.
85
85
 
86
+ ## La nota de una consola (de qué va)
87
+
88
+ Cada consola lleva una nota de texto libre: la tarea en curso, lo que falta. Sale en una tarjeta
89
+ flotante sobre la consola (junto con su título) y, su primera línea, en la lista de consolas. La
90
+ edita la persona desde la tarjeta, o el programa que corre dentro:
91
+
92
+ ```bash
93
+ dotrino-terminal note # la enseña
94
+ dotrino-terminal note "texto" # la reemplaza («-» la lee de la entrada estándar)
95
+ dotrino-terminal note --add "línea" # le añade una línea
96
+ dotrino-terminal note --clear # la borra
97
+ dotrino-terminal note --task "tarea" # la tarea en curso (líneas «▸ », arriba) sin tocar lo demás
98
+ ```
99
+
100
+ `--task` es la forma que usa un programa: reemplaza solo sus líneas marcadas y deja las notas de
101
+ la persona tal cual.
102
+
103
+ Sin `--id`, es la consola en la que corre la orden: el agente pone su id en
104
+ `DOTRINO_TERMINAL_CONSOLE`. Vive en memoria, como la consola: se va con ella. Hasta 4000 caracteres.
105
+
106
+ Para que un agente de IA la mantenga al día, el paquete trae un skill de Claude Code en
107
+ `skills/dotrino-terminal-note/`: se copia a `~/.claude/skills/`.
108
+
86
109
  ## Clave de la máquina (opcional)
87
110
 
88
111
  Por defecto, cualquier aparato de tu cuenta con permiso abre consolas en esta máquina. Si
package/bin/terminal.js CHANGED
@@ -6,6 +6,7 @@
6
6
  * dotrino-terminal attach <id> [--name <n>] se engancha a una consola que ya existe
7
7
  * dotrino-terminal ls [--name <n>] [--json] las consolas abiertas en el agente
8
8
  * dotrino-terminal kill <id> [--name <n>] cierra una consola
9
+ * dotrino-terminal note [texto] la nota de esta consola (de qué va): la lee o la cambia
9
10
  * dotrino-terminal profiles [--json] los perfiles de esta máquina (enlazados o no)
10
11
  * dotrino-terminal link [--name <n>] enlaza un perfil con tu bóveda
11
12
  * dotrino-terminal rename <perfil> [nuevo] renombra un perfil (para su agente si corre)
@@ -55,6 +56,13 @@ if (args.includes('-h') || args.includes('--help')) {
55
56
  dotrino-terminal attach <id> [--name <n>] se engancha a una consola abierta
56
57
  dotrino-terminal ls [--name <n>] [--json] las consolas abiertas
57
58
  dotrino-terminal kill <id> [--name <n>] cierra una consola
59
+ dotrino-terminal note enseña la nota de esta consola (de qué va)
60
+ dotrino-terminal note <texto> la reemplaza («-» la lee de la entrada estándar)
61
+ dotrino-terminal note --add <texto> le añade una línea
62
+ dotrino-terminal note --clear la borra
63
+ dotrino-terminal note --task <texto> pone la tarea en curso (líneas «▸ », arriba) y NO toca
64
+ lo demás: es la que usa un programa; --task '' la quita
65
+ (--id <id> para otra consola; --json para leerla una máquina)
58
66
  dotrino-terminal profiles [--json] los perfiles de esta máquina
59
67
  dotrino-terminal link [--name <n>] enlaza un perfil con tu bóveda
60
68
  dotrino-terminal rename <perfil> [nuevo] renombra un perfil (para su agente: cierra sus consolas)
@@ -74,6 +82,13 @@ Cerrar la ventana no cierra la consola: sigue abierta y se retoma después.`, `u
74
82
  dotrino-terminal attach <id> [--name <n>] attach to an open console
75
83
  dotrino-terminal ls [--name <n>] [--json] list open consoles
76
84
  dotrino-terminal kill <id> [--name <n>] close a console
85
+ dotrino-terminal note show this console's note (what it is about)
86
+ dotrino-terminal note <text> replace it ("-" reads it from standard input)
87
+ dotrino-terminal note --add <text> append a line
88
+ dotrino-terminal note --clear clear it
89
+ dotrino-terminal note --task <text> set the task in progress ("▸ " lines, on top) WITHOUT
90
+ touching the rest: the one a program uses; --task '' removes it
91
+ (--id <id> for another console; --json for a machine to read)
77
92
  dotrino-terminal profiles [--json] this machine's profiles
78
93
  dotrino-terminal link [--name <n>] link a profile with your vault
79
94
  dotrino-terminal rename <profile> [new] rename a profile (stops its agent: closes its consoles)
@@ -372,6 +387,60 @@ async function list (conn) {
372
387
  }
373
388
  }
374
389
 
390
+ /**
391
+ * La nota de una consola: de qué va. Sin `--id` es la consola en la que corre esta orden (el
392
+ * agente pone su id en `DOTRINO_TERMINAL_CONSOLE`), que es como la cambia un programa desde dentro.
393
+ * No levanta ningún agente: sin agente no hay consola a la que ponerle nota.
394
+ */
395
+ /** La marca de las líneas que pone un programa con `note --task`. */
396
+ const TASK_MARK = '▸ '
397
+
398
+ async function note () {
399
+ const id = opt('--id') || process.env.DOTRINO_TERMINAL_CONSOLE
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").'))
401
+ // Dentro de una consola, el perfil es el de esa consola, no el `default`.
402
+ const dir = opt('--dir') || (opt('--name') ? dataDir(opt('--name')) : process.env.DOTRINO_TERMINAL_PROFILE_DIR || dataDir())
403
+ const valued = new Set(['--id', '--dir', '--name', '--add', '--task'])
404
+ const words = []
405
+ for (let i = 1; i < args.length; i++) {
406
+ if (valued.has(args[i])) { i++; continue }
407
+ if (args[i] === '-' || !args[i].startsWith('-')) words.push(args[i])
408
+ }
409
+ const stdin = () => fs.readFileSync(0, 'utf8').replace(/\n+$/, '')
410
+ const given = words.length ? (words.length === 1 && words[0] === '-' ? stdin() : words.join(' ')) : null
411
+ const add = opt('--add') === '-' ? stdin() : opt('--add')
412
+ const task = opt('--task') === '-' ? stdin() : opt('--task')
413
+ let conn
414
+ try { conn = await connectLocal(dir) } catch (e) {
415
+ if (e.code !== 'ENOAGENT') throw e
416
+ die(t('el agente de este perfil no está corriendo.', 'this profile\'s agent is not running.'))
417
+ }
418
+ const ask = async (msg) => {
419
+ const r = await Promise.race([request(conn, msg, 'noted'), new Promise((resolve) => setTimeout(() => resolve(null), 5000))])
420
+ // Un agente anterior a la 0.36 no conoce la orden y no contesta: se dice, no se da por hecho.
421
+ if (!r) die(t('el agente no contestó: es anterior a la 0.36.0 y no tiene notas. Actualízalo y reinícialo.', 'the agent did not answer: it predates 0.36.0 and has no notes. Update and restart it.'))
422
+ if (r.type === 'fail') die(`dotrino-terminal: ${r.message} (${r.code})`)
423
+ return r.console
424
+ }
425
+ let c
426
+ if (task !== undefined) {
427
+ // LA TAREA ES DEL PROGRAMA, LO DEMÁS ES DE LA PERSONA. Las líneas de la tarea llevan su marca
428
+ // y van arriba; cambiar la tarea quita las marcadas de antes y deja el resto TAL CUAL, línea
429
+ // por línea. Así un agente de IA no puede pisar una nota personal ni por descuido.
430
+ const kept = ((await ask({ type: 'note', id })).note || '').split('\n').filter((l) => !l.startsWith(TASK_MARK))
431
+ const mine = task.split('\n').map((l) => l.trim()).filter(Boolean).map((l) => TASK_MARK + l)
432
+ c = await ask({ type: 'note', id, text: [...mine, ...kept].join('\n').replace(/^\n+|\n+$/g, '') })
433
+ } else if (args.includes('--clear')) c = await ask({ type: 'note', id, text: '' })
434
+ else if (add !== undefined) {
435
+ const before = (await ask({ type: 'note', id })).note || ''
436
+ c = await ask({ type: 'note', id, text: before ? `${before}\n${add}` : add })
437
+ } else if (given !== null) c = await ask({ type: 'note', id, text: given })
438
+ else c = await ask({ type: 'note', id })
439
+ conn.close()
440
+ if (args.includes('--json')) console.log(JSON.stringify({ id: c.id, n: c.n, title: c.title, note: c.note }, null, 2))
441
+ else if (c.note) console.log(c.note)
442
+ }
443
+
375
444
  /** La ventana: la TTY enganchada a una consola del agente. */
376
445
  function interactive (conn, first, dir) {
377
446
  // Hasta que el agente diga `attached` no hay consola a la que escribir: se guarda.
@@ -550,6 +619,7 @@ try {
550
619
  if (cmd === 'rename') { await rename(); process.exit(0) }
551
620
  if (cmd === 'lock') { await lock(); process.exit(0) }
552
621
  if (cmd === 'vscode') { vscode(); process.exit(0) }
622
+ if (cmd === 'note') { await note(); process.exit(0) }
553
623
  const dir = opt('--dir') || dataDir(opt('--name'))
554
624
  if (cmd === 'open' || cmd === 'attach') captureEarly()
555
625
  const conn = await agent(dir)
package/consoles.js CHANGED
@@ -43,6 +43,8 @@ const MIN_TASK_MS = 3000 // menos que esto no fue «una tarea»: no se marca c
43
43
  // Cerrar una consola: SIGHUP al momento y, si la shell sigue viva, SIGTERM y luego SIGKILL.
44
44
  export const KILL_TERM_MS = 1500
45
45
  export const KILL_KILL_MS = 3000
46
+ /** Lo más largo que puede ser la nota de una consola. Viaja con cada `info`: tiene que ser corta. */
47
+ export const NOTE_MAX = 4000
46
48
 
47
49
  /**
48
50
  * La carpeta en la que está AHORA el proceso de una consola (la shell), con `~` por la carpeta
@@ -78,6 +80,9 @@ class Console {
78
80
  this.pty = pty
79
81
  this.origin = origin // 'local' (una ventana de esta máquina) | 'remote' (otro aparato)
80
82
  this.title = '' // el que pone la shell (OSC 0/2), para reconocerla en la lista
83
+ // DE QUÉ VA esta consola: una nota libre que escribe la persona desde cualquier pantalla, o el
84
+ // programa que corre dentro (`dotrino-terminal note`). En memoria, como todo lo de la consola.
85
+ this.note = ''
81
86
  this.cols = cols
82
87
  this.rows = rows
83
88
  this.createdAt = Date.now()
@@ -139,7 +144,15 @@ class Console {
139
144
  this._meta()
140
145
  }
141
146
 
142
- /** Avisa a todos los que miran de que cambió quién mira o el título. */
147
+ /** Cambia la nota. Lo ve al momento quien mira la consola; los demás, en la lista. */
148
+ setNote (text) {
149
+ const note = String(text ?? '').slice(0, NOTE_MAX)
150
+ if (note === this.note) return
151
+ this.note = note
152
+ this._meta()
153
+ }
154
+
155
+ /** Avisa a todos los que miran de que cambió quién mira, el título o la nota. */
143
156
  _meta () {
144
157
  const info = this.info()
145
158
  for (const v of this.viewers) v.onMeta?.(info)
@@ -250,7 +263,7 @@ class Console {
250
263
  const watchers = [...this.viewers].filter((v) => v.origin).map((v) => ({ origin: v.origin, device: v.device || null, tag: v.tag || null }))
251
264
  const d = this.holder
252
265
  const sizeBy = d ? { origin: d.origin || null, device: d.device || null, tag: d.tag || null } : null
253
- return { id: this.id, n: this.n, activity: this.busy ? 'busy' : 'idle', doneAt: this.doneAt, sizeBy, origin: this.origin, title: this.title, host: HOST, cwd: cwdOf(this.pty?.pid), cols: this.cols, rows: this.rows, createdAt: this.createdAt, lastActive: this.lastActive, viewers: this.viewers.size, watchers }
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 }
254
267
  }
255
268
  }
256
269
 
@@ -276,8 +289,9 @@ export function isTyped (data) { return String(data).replace(REPORTS, '') !== ''
276
289
  /** Las consolas de este agente. */
277
290
  export class ConsoleHub {
278
291
  /**
279
- * @param {{ spawn:(opts:{cols:number,rows:number,cwd:string|null})=>any }} opts
280
- * `spawn` lanza la shell (un PTY con `onData`, `onExit`, `write`, `resize`, `kill`).
292
+ * @param {{ spawn:(opts:{cols:number,rows:number,cwd:string|null,id:string})=>any }} opts
293
+ * `spawn` lanza la shell (un PTY con `onData`, `onExit`, `write`, `resize`, `kill`). `id` es el de
294
+ * la consola: va en el entorno de la shell para que lo que corre dentro sepa cuál es la suya.
281
295
  */
282
296
  constructor ({ spawn, quietMs = QUIET_MS }) {
283
297
  this._spawn = spawn
@@ -295,7 +309,7 @@ export class ConsoleHub {
295
309
  const used = new Set([...this.consoles.values()].map((c) => c.n))
296
310
  let n = 1
297
311
  while (used.has(n)) n++
298
- const pty = this._spawn({ cols, rows, cwd })
312
+ const pty = this._spawn({ cols, rows, cwd, id })
299
313
  const c = new Console({ id, n, pty, cols, rows, origin, quietMs: this._quietMs })
300
314
  pty.onData((d) => c._out(d))
301
315
  pty.onExit(({ exitCode }) => {
package/index.js CHANGED
@@ -15,11 +15,13 @@
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
20
  * { type:'unlock', code } (la clave de la máquina, si tiene: access.js)
19
21
  * agente → cliente: { type:'consoles', list } · { type:'attached', id, fresh } ·
20
22
  * { type:'replay', id, data, last } · { type:'out', data } ·
21
23
  * { type:'exit', code, closedBy? } · { type:'fail', code, message, retryMs? } ·
22
- * { type:'unlocked' }
24
+ * { type:'unlocked' } · { type:'noted', console }
23
25
  *
24
26
  * Con clave puesta, una sesión remota que no la ha escrito recibe `fail` con `code:'locked'`
25
27
  * a todo lo que pida; tras `unlock` vale para esa conexión. `bad-code` y `wait` traen
@@ -64,12 +66,13 @@ export function makeHub (pty, opts = {}) {
64
66
  const shell = opts.shell || process.env.SHELL || (process.platform === 'win32' ? 'powershell.exe' : 'bash')
65
67
  return new ConsoleHub({
66
68
  ...(opts.quietMs ? { quietMs: opts.quietMs } : {}),
67
- spawn: ({ cols, rows, cwd }) => pty.spawn(shell, [], {
69
+ spawn: ({ cols, rows, cwd, id }) => pty.spawn(shell, [], {
68
70
  name: 'xterm-256color', cols, rows,
69
71
  cwd: cwd || os.homedir(),
70
72
  // La carpeta del perfil viaja a la shell: `dotrino-terminal rename` sabe así si corre
71
73
  // dentro del mismo perfil que renombra (y que parar su agente cerraría su consola).
72
- env: { ...process.env, TERM: 'xterm-256color', ...(opts.dir ? { DOTRINO_TERMINAL_PROFILE_DIR: opts.dir } : {}) }
74
+ // El id de la consola también: `dotrino-terminal note` sabe así cuál es la suya.
75
+ env: { ...process.env, TERM: 'xterm-256color', DOTRINO_TERMINAL_CONSOLE: id, ...(opts.dir ? { DOTRINO_TERMINAL_PROFILE_DIR: opts.dir } : {}) }
73
76
  })
74
77
  })
75
78
  }
@@ -203,6 +206,14 @@ export function serveSession (session, hub, { origin = 'remote', gate = null } =
203
206
  if (msg.type === 'take') { current?.take(viewer); return }
204
207
  if (msg.type === 'close') { if (current) hub.kill(current.id, viewer); return }
205
208
  if (msg.type === 'kill') { if (!hub.kill(msg.id, viewer)) fail('no-console', 'that console no longer exists'); return }
209
+ // La nota de una consola (de qué va): la escribe cualquier pantalla, o lo que corre dentro.
210
+ if (msg.type === 'note') {
211
+ const c = msg.id == null ? current : hub.get(String(msg.id))
212
+ if (!c) return fail('no-console', 'that console no longer exists')
213
+ if (typeof msg.text === 'string') c.setNote(msg.text)
214
+ session.send({ type: 'noted', console: c.info() })
215
+ return
216
+ }
206
217
  // El orden del panel: es de la máquina, así que lo ve igual cualquier pantalla.
207
218
  if (msg.type === 'move') {
208
219
  if (!hub.move(String(msg.id), msg.before == null ? null : String(msg.before))) return fail('no-console', 'that console no longer exists')
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@dotrino/terminal-agent",
3
- "version": "0.35.0",
3
+ "version": "0.36.1",
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": {
@@ -19,7 +19,8 @@
19
19
  "local.js",
20
20
  "title.js",
21
21
  "update.js",
22
- "bin"
22
+ "bin",
23
+ "skills"
23
24
  ],
24
25
  "scripts": {
25
26
  "start": "node bin/cli.js",
@@ -0,0 +1,73 @@
1
+ ---
2
+ name: 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
+ ---
5
+
6
+ # La tarea en curso de la consola (Dotrino Terminal)
7
+
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
+ En la nota conviven dos cosas:
13
+
14
+ - **La tarea** (líneas que empiezan por `▸ `, arriba): es TUYA. La pones con `--task`.
15
+ - **Todo lo demás**: son **notas personales del dueño**. No son tuyas.
16
+
17
+ ## Regla dura: las notas personales no se tocan
18
+
19
+ **Usa SOLO `dotrino-terminal note --task`.** Esa orden reemplaza tus líneas `▸ ` y deja el resto
20
+ tal cual, así que no puedes pisar nada 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 la nota ENTERA)
25
+ - `dotrino-terminal note --add …` (escribe una línea como si fuera suya)
26
+ - `dotrino-terminal note --clear` (la borra entera)
27
+
28
+ No reescribas, ordenes, corrijas ni resumas lo que él escribió. Tampoco lo copies a tus líneas.
29
+
30
+ ## Cuándo
31
+
32
+ 1. Comprueba que corres dentro de una consola: `echo "$DOTRINO_TERMINAL_CONSOLE"`. Vacío = no hay
33
+ consola ni tarjeta: no hagas nada y no lo menciones.
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.
37
+
38
+ Una orden por momento, sin anunciarlo ni comentarlo en la respuesta.
39
+
40
+ ## Cómo
41
+
42
+ ```bash
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
46
+ Arreglando el login de facturero
47
+ Falta: probar con firma real
48
+ EOF_TASK
49
+
50
+ dotrino-terminal note --task '' # quita tu tarea (lo del dueño se queda)
51
+ dotrino-terminal note # solo LEER la nota entera
52
+ ```
53
+
54
+ No hace falta decir qué consola: es la tuya.
55
+
56
+ ## Qué escribir
57
+
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.
62
+ - En el idioma del usuario. Sin secretos, llaves ni rutas con credenciales: la nota la ven todos
63
+ los aparatos de la cuenta.
64
+ - Al terminar no la quites: di que terminó (`Terminado: …`).
65
+
66
+ ## Si falla
67
+
68
+ - «no sé de qué consola» / `no console to act on`: no corres dentro de Dotrino Terminal. Sigue sin nota.
69
+ - `--task` no hace nada o cambia la nota entera: el `dotrino-terminal` instalado es anterior a la
70
+ 0.36.1. **No uses las otras formas como sustituto**: díselo al usuario una vez
71
+ (`npm i -g @dotrino/terminal-agent@latest`) y sigue sin nota.
72
+ - «el agente no contestó: es anterior a la 0.36.0»: díselo al usuario una vez y no lo reintentes.
73
+ - **Nunca reinicies el agente tú**: corres dentro de él y reiniciarlo cierra esta consola.