@dotrino/terminal-agent 0.24.1 → 0.25.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
@@ -80,6 +80,11 @@ dotrino-terminal lock --status [--name <perfil>] # dice si hay
80
80
  En la app de escritorio: menú **Perfil → Poner o cambiar la clave… / Quitar la clave**.
81
81
 
82
82
  - Es **del perfil**: todas sus consolas comparten la misma clave.
83
+ - A los **tres fallos seguidos** toca esperar, cada vez más (freno local de este agente). Y si un
84
+ mismo aparato falla tres veces seguidas, el agente **reporta el incidente a la bóveda**
85
+ (`reportIncident` de `@dotrino/remote-agent` ≥ 0.16.0): los aparatos que aprueban lo ven y
86
+ eligen bloquear o ignorar. Bloqueado, no entra en ningún agente ni en la bóveda hasta
87
+ `dotrino-vault unblock <ID>`.
83
88
  - La piden **solo los otros aparatos** (web, teléfono). Las ventanas de esta máquina no.
84
89
  - Vale **al momento**, sin reiniciar el agente: quien ya estaba dentro tiene que escribirla
85
90
  en lo siguiente que haga.
package/access.js CHANGED
@@ -10,7 +10,12 @@
10
10
  * sesión cifrada entre el aparato y el agente, así que el proxio no la ve.
11
11
  *
12
12
  * Los fallos se frenan POR AGENTE y no por sesión: quien prueba claves puede abrir otra
13
- * conexión, y eso no le da intentos nuevos.
13
+ * conexión, y eso no le da intentos nuevos. A los TRES seguidos (dueño, 2026-10-07) empieza
14
+ * la espera, que se dobla con cada fallo más: es un bloqueo LOCAL de este servicio, nada más.
15
+ *
16
+ * Y a los tres fallos seguidos de UN MISMO aparato se avisa (`onIncident`): la bóveda se lo
17
+ * pone en la mesa a quien aprueba, que bloquea o ignora desde el teléfono. Avisar no decide
18
+ * nada aquí; el freno de arriba sigue igual.
14
19
  */
15
20
  import crypto from 'node:crypto'
16
21
  import fs from 'node:fs'
@@ -18,8 +23,10 @@ import path from 'node:path'
18
23
 
19
24
  export const ACCESS_FILE = 'access.json'
20
25
  export const MIN_LENGTH = 4
21
- /** Fallos seguidos que se dejan pasar sin esperar. */
22
- export const FREE_TRIES = 5
26
+ /** Fallos seguidos que se dejan pasar sin esperar: al tercero empieza la espera. */
27
+ export const FREE_TRIES = 3
28
+ /** Fallos seguidos de un mismo aparato que disparan el aviso a la bóveda. */
29
+ export const INCIDENT_AFTER = 3
23
30
  const BASE_WAIT_MS = 30_000
24
31
  const MAX_WAIT_MS = 60 * 60_000
25
32
  const SCRYPT = { N: 1 << 15, r: 8, p: 1, maxmem: 64 * 1024 * 1024 }
@@ -75,21 +82,33 @@ export function checkAccessCode (dir, secret) {
75
82
  * La puerta de un agente: comprueba la clave y frena los fallos seguidos. Una por agente,
76
83
  * compartida por todas sus sesiones.
77
84
  * @param {string} dir
78
- * @param {{ now?: () => number }} [opts]
85
+ * @param {{ now?: () => number, onIncident?: (i: { device: string, tries: number }) => void }} [opts]
86
+ * `onIncident`: un mismo aparato (`device`, su pubkey) falló `INCIDENT_AFTER` veces seguidas.
87
+ * Se llama UNA vez por racha; la racha se corta al acertar.
79
88
  */
80
- export function makeGate (dir, { now = Date.now } = {}) {
89
+ export function makeGate (dir, { now = Date.now, onIncident = null } = {}) {
81
90
  let fails = 0
82
91
  let until = 0
92
+ /** Fallos seguidos por aparato: el aviso es sobre QUIÉN, y el freno sobre el agente. */
93
+ const byDevice = new Map()
83
94
  return {
84
95
  /** Si hay que escribir la clave para entrar. Lanza `access-unreadable` si no se puede saber. */
85
96
  required: () => hasAccessCode(dir),
86
- /** Lanza `wait` (con `retryMs`) o `bad-code`; si no lanza, la clave era la buena. */
87
- check (secret) {
97
+ /**
98
+ * Lanza `wait` (con `retryMs`) o `bad-code`; si no lanza, la clave era la buena.
99
+ * `device` es quién la escribió (pubkey), para contar sus fallos y avisar.
100
+ */
101
+ check (secret, device = null) {
88
102
  const left = until - now()
89
103
  if (left > 0) throw fail('wait', 'too many wrong codes', { retryMs: left })
90
- if (checkAccessCode(dir, secret)) { fails = 0; until = 0; return }
104
+ if (checkAccessCode(dir, secret)) { fails = 0; until = 0; if (device) byDevice.delete(device); return }
91
105
  fails++
92
106
  if (fails >= FREE_TRIES) until = now() + Math.min(BASE_WAIT_MS * 2 ** (fails - FREE_TRIES), MAX_WAIT_MS)
107
+ if (device) {
108
+ const n = (byDevice.get(device) || 0) + 1
109
+ byDevice.set(device, n)
110
+ if (n === INCIDENT_AFTER && onIncident) { try { onIncident({ device, tries: n }) } catch (_) {} }
111
+ }
93
112
  throw fail('bad-code', 'wrong code', until ? { retryMs: until - now() } : {})
94
113
  }
95
114
  }
package/index.js CHANGED
@@ -134,7 +134,7 @@ export function serveSession (session, hub, { origin = 'remote', gate = null } =
134
134
  if (msg.type === 'unlock') {
135
135
  if (origin !== 'remote' || !gate) { session.send({ type: 'unlocked' }); return }
136
136
  try {
137
- if (gate.required()) gate.check(msg.code)
137
+ if (gate.required()) gate.check(msg.code, viewer.device)
138
138
  unlocked = true
139
139
  session.send({ type: 'unlocked' })
140
140
  } catch (e) { fail(e.code || 'access-unreadable', e.message, e.retryMs ? { retryMs: e.retryMs } : {}) }
@@ -204,9 +204,19 @@ export function serveSession (session, hub, { origin = 'remote', gate = null } =
204
204
  export async function startAgent (opts = {}) {
205
205
  const dir = opts.dir || dataDir()
206
206
  const hub = makeHub(loadPty(), { ...opts, dir })
207
- const gate = makeGate(dir)
208
- const local = await listenLocal({ dir, serve: (session) => serveSession(session, hub, { origin: 'local' }) })
209
207
  let remote = null
208
+ // TRES CLAVES MAL SEGUIDAS DE UN MISMO APARATO: se reporta a la bóveda, que se lo pone en
209
+ // la mesa a quien aprueba (bloquear o ignorar). El freno local ya está puesto; esto es el
210
+ // aviso. Si no se puede reportar se dice: un aviso que no sale es un teléfono que no suena.
211
+ const gate = makeGate(dir, {
212
+ onIncident: ({ device, tries }) => {
213
+ if (!remote?.reportIncident) return
214
+ remote.reportIncident({ kind: 'bad-code', about: device, tries })
215
+ .then((r) => { if (!opts.quiet) console.log(`[terminal-agent] incident reported: ${r.id ? `request ${r.id} to ${r.approvers} approver(s)` : r.blocked ? 'that device is already blocked' : 'nobody can approve, nothing asked'}`) })
216
+ .catch((e) => console.error(`[terminal-agent] could not report the incident: ${e.message}`))
217
+ }
218
+ })
219
+ const local = await listenLocal({ dir, serve: (session) => serveSession(session, hub, { origin: 'local' }) })
210
220
  let stopped = false
211
221
  const startRemote = () => startRemoteAgent({
212
222
  label: LABEL,
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@dotrino/terminal-agent",
3
- "version": "0.24.1",
3
+ "version": "0.25.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": {
@@ -28,7 +28,7 @@
28
28
  "dependencies": {
29
29
  "@dotrino/identity": "0.107.2",
30
30
  "@dotrino/proxy-client": "0.29.0",
31
- "@dotrino/remote-agent": "0.15.1",
31
+ "@dotrino/remote-agent": "0.16.0",
32
32
  "@dotrino/update": "0.2.2",
33
33
  "@dotrino/vault": "0.79.0",
34
34
  "@xterm/addon-serialize": "0.13.0",