@dotrino/vaultd 0.133.0 → 0.135.0

package/lib/src/env.js

@@ -21,7 +21,7 @@
 import fs from 'node:fs'
 import os from 'node:os'
 import path from 'node:path'
-import { fetchSecrets, waitForSecrets, readServiceIdentity, watchSecretsChanges } from './service.js'
+import { fetchSecrets, waitForSecrets, readServiceIdentity, watchSecretsChanges, lastDigestOf } from './service.js'
 import { isValidSecretsNs } from './protocol.js'
 
 /** Raíz donde viven las identidades de servicio de esta máquina/usuario. */
@@ -276,10 +276,14 @@ export async function watchEnv ({ ns, vault, dir, applied = lastApplied ?? undef
     process.exit(reason === 'revoked' ? 1 : exitCode)
   }
 
+  // La HUELLA de lo que este proceso puso a correr (la trajo el cajón al pedirlo). Con ella la
+  // primera comparación ya detecta un cambio ocurrido entre pedir y escuchar, sin volver a
+  // pedir las claves — que a un servicio con aprobación le hacía sonar el teléfono al dueño.
+  const pub = readServiceIdentity(dir)?.device?.publickey
   return watchSecretsChanges({
     dir,
     ns,
-    applied,
+    digest: applied !== undefined && pub ? lastDigestOf(ns, pub) : null,
     log: say,
     onChange: ({ ts, via }) => (onUpdate ? onUpdate({ ns, ts, reason: 'changed', via }) : exitNow('changed')),
     // Un cert revocado sale con código de FALLO a propósito: si el supervisor lo

package/lib/src/service.js

@@ -512,6 +512,114 @@ export async function registerEncKey ({ dir, ns, proxyUrl, masterPubkey, device,
   } finally { client.close() }
 }
 
+/**
+ * GUARDA VARIABLES EN EL CAJÓN DE ESTE SERVICIO (dueño, 2026-09-29: «para facilitar la
+ * migración de ENVs a Dotrino»). Es lo que hay detrás de `dotrino-env import`.
+ *
+ * Los valores se sellan AQUÍ, en la máquina del servicio, para quien diga el acta; la
+ * bóveda recibe sobres que no abre. La lista de destinatarios la firma la bóveda y se
+ * comprueba (`verifyResponder`): si el proxio pudiera cambiarla por sus llaves, abriría las
+ * privadas al pasar.
+ *
+ * Lo que decide la bóveda, no este cliente:
+ *   · si hay quien apruebe, se pide aprobación siempre, y al aprobarse puede EDITAR;
+ *   · si nadie puede aprobar, solo AÑADE lo que falta (una que ya exista falla con `exists`);
+ *   · BORRAR no existe por aquí.
+ *
+ * @param {object} o
+ * @param {Array<{ key:string, value:string, public?:boolean }>} o.vars
+ * @param {string} [o.dir]  identidad de `dotrino-env` (`service-identity.json`); o, en su
+ *   lugar, la identidad por parámetros (`ns`, `proxyUrl`, `masterPubkey`, `device`, `cert`),
+ *   que es como la trae un agente de remote-agent.
+ * @returns {Promise<{ keys: string[], pending: string|null, approval: boolean }>}
+ *   `pending`: el id del pedido de aprobación (se guarda al aprobar); `keys`: lo guardado ya.
+ */
+export async function storeVars ({ dir, ns, proxyUrl, masterPubkey, device, cert, vars, timeoutMs = 30000 } = {}) {
+  const saved = dir ? readServiceIdentity(dir) : null
+  ns = ns || saved?.ns
+  proxyUrl = proxyUrl || saved?.proxy
+  masterPubkey = masterPubkey || saved?.iss
+  device = device || saved?.device
+  cert = cert || saved?.cert
+  if (!isValidSecretsNs(ns)) throw new Error('invalid ns')
+  if (!proxyUrl || !masterPubkey || !device || !cert) throw new Error('service not enrolled')
+  if (!Array.isArray(vars) || !vars.length) throw new Error('storeVars: no variables to store')
+  for (const v of vars) {
+    if (typeof v?.key !== 'string' || !v.key) throw new Error('storeVars: every variable needs a key')
+    if (typeof v.value !== 'string' || !v.value) throw Object.assign(new Error(`storeVars: "${v.key}" has no value`), { code: 'novalue' })
+  }
+
+  const client = await freshClient(proxyUrl, 20000, masterPubkey)
+  try {
+    await identifyAsService(client, device)
+    const ask = async (data) => {
+      const signed = { ...data, ns, publickey: device.publickey, ts: Date.now() }
+      const { signature } = await signWithDevice({ privateJwk: device.privateJwk, data: signed })
+      const pending = waitForMsg(client, (p) => p.type === MSG.SECRETS_RESULT || p.type === MSG.ERROR, timeoutMs)
+      client.sendByPubkey(masterPubkey, { type: MSG.SECRETS, data: signed, signature, cert })
+      const res = await pending
+      if (res.type === MSG.ERROR) throw vaultError(res)
+      await verifyResponder({ body: res.body, seal: res.seal, acta: res.acta, masterPubkey, knownSeq: saved?.actaSeq ?? null })
+      if (res.body?.op !== data.op.replace(/^store$/, 'store.result') || res.body?.ns !== ns) throw new Error('the vault answered something else')
+      return res.body
+    }
+
+    const { recipients, approval } = await ask({ op: 'store.recipients' })
+    const { buildSealedVar, authorFromDeviceKey } = await import('./admin.js')
+    const author = authorFromDeviceKey(device)
+    const items = []
+    for (const v of vars) {
+      const sealed = await buildSealedVar({
+        recipients: v.public ? recipients.public : recipients.private,
+        owner: `ns:${ns}`, key: v.key, value: v.value, author
+      })
+      items.push({ key: v.key, sealed, public: !!v.public })
+    }
+    const nonce = [...crypto.getRandomValues(new Uint8Array(16))].map((x) => x.toString(16).padStart(2, '0')).join('')
+    const r = await ask({ op: 'store', items, nonce })
+    return { keys: r.keys || [], pending: r.pending || null, approval: !!approval }
+  } finally { client.close() }
+}
+
+/** La huella del último cajón recibido, por `ns` + aparato (ver `fetchDigest`). */
+const lastDigests = new Map()
+const digestKey = (ns, pub) => ns + String.fromCharCode(0) + pub
+/** La huella del cajón que este proceso recibió por última vez, o `null`. */
+export function lastDigestOf (ns, publickey) { return lastDigests.get(digestKey(ns, publickey)) ?? null }
+
+/**
+ * ¿CAMBIÓ LA CONFIGURACIÓN? Pregunta la HUELLA del cajón —nombres, visibilidad y generación,
+ * ningún valor— y por eso no pide aprobación (dueño, 2026-09-30: «revisa que no se pidan
+ * aprobaciones sin motivo»). Es lo que usa `watchSecretsChanges` al reconectarse; antes
+ * pedía el cajón entero y a un servicio con aprobación le sonaba el teléfono al dueño en
+ * cada despliegue del proxio.
+ * @returns {Promise<string>} la huella
+ */
+export async function fetchDigest ({ dir, ns, proxyUrl, masterPubkey, device, cert, timeoutMs = 20000 } = {}) {
+  const saved = dir ? readServiceIdentity(dir) : null
+  ns = ns || saved?.ns
+  proxyUrl = proxyUrl || saved?.proxy
+  masterPubkey = masterPubkey || saved?.iss
+  device = device || saved?.device
+  cert = cert || saved?.cert
+  if (!isValidSecretsNs(ns)) throw new Error('invalid ns')
+  if (!proxyUrl || !masterPubkey || !device || !cert) throw new Error('service not enrolled')
+  const client = await freshClient(proxyUrl, 20000, masterPubkey)
+  try {
+    await identifyAsService(client, device)
+    const data = { op: 'digest', ns, publickey: device.publickey, ts: Date.now() }
+    const { signature } = await signWithDevice({ privateJwk: device.privateJwk, data })
+    const pending = waitForMsg(client, (p) => p.type === MSG.ERROR || (p.type === MSG.SECRETS_RESULT && p.body?.op === 'secrets.digest'), timeoutMs)
+    client.sendByPubkey(masterPubkey, { type: MSG.SECRETS, data, signature, cert })
+    const res = await pending
+    if (res.type === MSG.ERROR) throw vaultError(res)
+    await verifyResponder({ body: res.body, seal: res.seal, acta: res.acta, masterPubkey, knownSeq: saved?.actaSeq ?? null })
+    if (res.body.ns !== ns || typeof res.body.digest !== 'string') throw new Error('malformed digest reply')
+    if (typeof res.body.ts !== 'number' || Math.abs(Date.now() - res.body.ts) > FRESH_WINDOW_MS) throw new Error('stale digest reply')
+    return res.body.digest
+  } finally { client.close() }
+}
+
 /**
  * Pide los secretos del ns al vault (una petición puntual; lanza si falla).
  * Usa la identidad persistida por `enrollService` salvo que se pase explícita.
@@ -667,7 +775,10 @@ export async function fetchSecrets ({ dir, ns, proxyUrl, masterPubkey, device, c
       try { onPending?.({ id: res.body.id, ns, exp: res.body.exp }) } catch (_) {}
       const until = typeof res.body.exp === 'number' ? Math.max(5000, res.body.exp - Date.now() + 5000) : approvalTimeoutMs
       res = await waitForMsg(client, (p) => (p.type === MSG.SECRETS_RESULT && p.body?.op === 'secrets.result') || p.type === MSG.ERROR, Math.min(until, approvalTimeoutMs))
-        .catch((e) => { throw new Error(/timeout/.test(e.message) ? 'approval: nobody approved the request in time' : e.message) })
+        .catch((e) => {
+          if (/timeout/.test(e.message)) throw Object.assign(new Error('approval: nobody approved the request in time'), { code: 'unanswered' })
+          throw e
+        })
       if (res.type === MSG.ERROR) throw vaultError(res)
     }
 
@@ -686,6 +797,9 @@ export async function fetchSecrets ({ dir, ns, proxyUrl, masterPubkey, device, c
     const payload = await openSealed({ privateKey: eph.privateKey, enc: body.enc })
     await verifyResponder({ body, seal: res.seal, acta: payload?.acta, masterPubkey, knownSeq: saved?.actaSeq ?? null })
     anotarActa(payload?.acta)
+    // La huella de lo que se acaba de recibir: con ella se compara después (`fetchDigest`)
+    // sin volver a pedir claves. Ya comprobada: va dentro del cuerpo firmado.
+    if (typeof body.digest === 'string') lastDigests.set(digestKey(ns, device.publickey), body.digest)
 
     // DOS CAPAS DE SOBRE, y hacen cosas distintas:
     //   · la de fuera (`ek` efímera, recién abierta) tapa el TRAMO — el proxio no ve
@@ -941,11 +1055,10 @@ async function openSealedBundle (sealed, ident, acta = null, masterPubkey = null
  *   `via` dice por dónde se enteró: `notice` (llegó el aviso) o `reconcile` (nadie
  *   avisó y la comparación al reconectar encontró otra configuración).
  * @param {(info:{nonce:string})=>void} [opts.onRevoked]  Cert revocado: apagar YA.
- * @param {Record<string,string>} [opts.applied]  El bundle que el agente tiene EN USO.
- *   Pasarlo es lo que permite detectar un cambio ya en la PRIMERA conexión — el que
- *   ocurrió entre que el agente pidió su configuración y logró ponerse a escuchar. Sin
- *   él no se pierde la protección, solo empieza una conexión más tarde: la primera se
- *   limita a tomar la referencia.
+ * @param {string} [opts.digest]  La huella del cajón EN USO (`lastDigestOf(ns, pub)` tras
+ *   pedirlo). Con ella se detecta ya en la primera conexión un cambio ocurrido entre que el
+ *   agente pidió su configuración y logró ponerse a escuchar; sin ella la primera
+ *   comparación solo toma la referencia.
  * @param {number} [opts.graceMs=30000]      No obedecer avisos durante los primeros N ms.
  *   La comparación también lo respeta, pero **aplazándose** (el aviso sí se descarta):
  *   es lo que impide que un fallo sistemático se convierta en un ciclo de reinicios,
@@ -961,7 +1074,7 @@ async function openSealedBundle (sealed, ident, acta = null, masterPubkey = null
  *   encontró un cambio.
  */
 export async function watchSecretsChanges ({
-  dir, ns, onChange, onRevoked, applied, graceMs = 30000, minIntervalMs = 60000, jitterMs = 5000,
+  dir, ns, onChange, onRevoked, digest = null, graceMs = 30000, minIntervalMs = 60000, jitterMs = 5000,
   reconcileMinMs = 30000, log = () => {}
 } = {}) {
   const saved = dir ? readServiceIdentity(dir) : null
@@ -979,7 +1092,10 @@ export async function watchSecretsChanges ({
   let retryTimer = null
   // Huella de la configuración EN USO. Comparar huellas y no valores es lo que permite
   // decir «esto no es lo que está corriendo» sin volver a manejar los secretos.
-  let fingerprint = applied === undefined ? null : fingerprintOf(applied)
+  // La referencia es la HUELLA del cajón que está EN USO (la bóveda la manda con cada entrega:
+  // `lastDigestOf`). La pasa quien sabe qué aplicó; sin ella, la primera comparación solo la
+  // toma. Antes era el bundle entero (`applied`), y compararlo obligaba a volver a pedirlo.
+  let fingerprint = typeof digest === 'string' ? digest : null
   let firstConnection = true
   let lastReconcile = 0
   let reconciling = false
@@ -1137,9 +1253,11 @@ export async function watchSecretsChanges ({
       return false
     }
     reconciling = true
-    let bundle = null
+    let current = null
     try {
-      bundle = await fetchSecrets({ dir, ns })
+      // LA HUELLA, NO EL CAJÓN: preguntar si cambió no es pedir las claves, y no puede
+      // hacer sonar el teléfono de nadie.
+      current = await fetchDigest({ dir, ns })
     } catch (e) {
       // El cert revocado mientras estaba incomunicado: el `REVOKED` firmado se perdió
       // igual que el aviso, y esta es la única otra forma de enterarse. Lo demás (la
@@ -1156,8 +1274,7 @@ export async function watchSecretsChanges ({
       reconciling = false
       lastReconcile = Date.now()
     }
-    const current = fingerprintOf(bundle)
-    if (fingerprint === null) { fingerprint = current; return false }  // primera vez: solo tomar referencia
+    if (fingerprint === null) { fingerprint = current; return false }  // sin referencia: solo tomarla
     if (current === fingerprint) return false
     fingerprint = current
     lastObeyed = Date.now()
@@ -1210,16 +1327,6 @@ export async function watchSecretsChanges ({
   }
 }
 
-/**
- * Huella de un bundle. Las claves van ORDENADAS: el bundle se arma mezclando el cajón
- * del scope con el del aparato, así que el mismo contenido puede llegar en otro orden y
- * un cambio de orden no es un cambio de configuración.
- */
-function fingerprintOf (secrets) {
-  const pairs = Object.entries(secrets || {}).map(([k, v]) => [k, String(v)]).sort((a, b) => (a[0] < b[0] ? -1 : 1))
-  return createHash('sha256').update(JSON.stringify(pairs)).digest('hex')
-}
-
 /**
  * Bucle de arranque de un servicio: pide los secretos y, si el vault no está
  * disponible, REINTENTA para siempre (con backoff hasta `maxRetryMs`). El
@@ -1283,6 +1390,12 @@ export function isFinal (e) {
  * @param {number} approvalTimeoutMs  lo que dura un pedido de aprobación
  * @param {number} now
  */
+/** Cuánto esperar para volver a pedir tras `n` pedidos sin contestar: 0, 5, 10, 20… min, hasta 6 h. */
+export function unansweredDelay (n) {
+  if (!n) return 0
+  return Math.min(6 * 60 * 60 * 1000, 5 * 60 * 1000 * 2 ** (n - 1))
+}
+
 export function retryDelay (backoffMs, rangAt, approvalTimeoutMs = APPROVAL_TIMEOUT_MS, now = Date.now()) {
   if (!rangAt) return backoffMs
   return Math.max(backoffMs, approvalTimeoutMs - (now - rangAt))
@@ -1291,13 +1404,19 @@ export function retryDelay (backoffMs, rangAt, approvalTimeoutMs = APPROVAL_TIME
 export async function waitForSecrets ({ dir, ns, proxyUrl, masterPubkey, device, cert, enc, retryMs = 5000, maxRetryMs = 60000, approvalTimeoutMs = APPROVAL_TIMEOUT_MS, onRetry, onPending, onCert, publicOnly = false } = {}) {
   let backoff = retryMs
   let rangAt = 0   // cuándo timbró ESTE intento; 0 = no hubo aprobación de por medio
+  let unanswered = 0
   const notePending = (info) => { rangAt = Date.now(); onPending?.(info) }
   for (;;) {
     try {
       return await fetchSecrets({ dir, ns, proxyUrl, masterPubkey, device, cert, enc, approvalTimeoutMs, onPending: notePending, onCert, publicOnly })
     } catch (e) {
       if (isFinal(e)) throw e
-      const wait = retryDelay(backoff, rangAt, approvalTimeoutMs)
+      // UN PEDIDO QUE NADIE CONTESTÓ NO SE REPITE CADA CINCO MINUTOS (dueño, 2026-09-30:
+      // «que no se pidan aprobaciones sin motivo»). Volver a pedir en cuanto vence hacía sonar
+      // el teléfono toda la noche por un servicio que arrancó de madrugada: el dueño ya lo vio
+      // y no lo aprobó. Se espacia —5, 10, 20, 40 min… hasta 6 h— y se sigue esperando.
+      if (e?.code === 'unanswered') unanswered++
+      const wait = Math.max(retryDelay(backoff, rangAt, approvalTimeoutMs), unansweredDelay(unanswered))
       rangAt = 0
       try { onRetry?.(e, wait) } catch (_) {}
       await new Promise((r) => setTimeout(r, wait))

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dotrino/vaultd",
-  "version": "0.133.0",
+  "version": "0.135.0",
   "type": "module",
   "description": "Certificador personal de Dotrino: daemon headless que custodia la clave maestra y delega capacidades a tus dispositivos por el proxy. Tu CA propia.",
   "bin": {

package/src/vault.js

@@ -150,6 +150,11 @@ export async function startVault ({ dir = dataDir(), proxyUrl, log = console.log
    * permisos como los demás, y se quita quitándolo — sin acordarse de un registro escondido
    * en una máquina.
    */
+  /** ¿Hay en el acta alguien que pueda aprobar? Sin nadie, no se pide aprobación. */
+  function hasApprover (record) {
+    return !!record?.members?.some((m) => Acta.memberCan(record, m.pub, 'approve'))
+  }
+
   function needsApproval (pub, record) {
     if (!record) return true          // sin acta no se decide que sí: se pide permiso
     // SIN NADIE QUE APRUEBE, NO SE NECESITA APROBACIÓN (dueño, 2026-09-24: «la regla es, si
@@ -1423,6 +1428,124 @@ export async function startVault ({ dir = dataDir(), proxyUrl, log = console.log
     }
   }
 
+  /**
+   * UN SERVICIO GUARDA VARIABLES EN SU PROPIO CAJÓN (dueño, 2026-09-29: «para facilitar la
+   * migración de ENVs a Dotrino»). Es lo que usa `dotrino-env import`: el `.env` que ya
+   * existe en la máquina del servicio sube tal cual, sin copiarlo a mano en la consola.
+   *
+   * Va por el canal del servicio —el mismo que lee el cajón— y con SUS fronteras: el cert
+   * con `vault:secrets:<ns>` y el CN del acta. Así un servicio solo escribe en su cajón y
+   * nunca en el de otro. La guarda la hace la MISMA pieza que la consola (`varsDesk`): la
+   * firma del autor, las envolturas, la espera de aprobación. Aquí no hay otra puerta.
+   *
+   * Los límites (dueño, 2026-09-29):
+   *   · si hay alguien que aprueba, SIEMPRE se pide aprobación —`unattended` no exime— y con
+   *     el sí puede también EDITAR lo que ya existe;
+   *   · si nadie puede aprobar, no se pide y solo puede AÑADIR lo que falta;
+   *   · BORRAR, nunca: eso es de la consola y del CLI de la bóveda.
+   *
+   * Dos operaciones: `store.recipients` (para quién se sella: solo públicas, nada que ocultar)
+   * y `store` (los sobres ya hechos; la bóveda no los abre).
+   */
+  /**
+   * LA HUELLA DE UN CAJÓN, tal como lo recibiría este aparato: nombres y GENERACIÓN de cada
+   * variable, sin un solo valor. La visibilidad NO entra: taparla no cambia lo que el servicio
+   * lee (y no sube la generación ni avisa). La generación la sube el almacén al
+   * escribir, así que la huella cambia cuando cambia la configuración y no cuando la
+   * bóveda solo rehace envolturas al abrirse. (Una rotación de llaves —al quitar un
+   * aparato— sí la sube: el servicio se reinicia una vez, que es raro y no hace daño.)
+   */
+  function drawerDigest (ns, devicePub) {
+    const b = secrets.bundleFor(ns, devicePub)
+    const filas = Object.entries(b.entries || {})
+      .map(([k, e]) => [k, b.legacy ? nodeCrypto.createHash('sha256').update(String(e.v)).digest('hex') : (e.gen ?? null)])
+      .sort((a, c) => (a[0] < c[0] ? -1 : 1))
+    return nodeCrypto.createHash('sha256').update(JSON.stringify(filas)).digest('hex')
+  }
+
+  /**
+   * ¿CAMBIÓ MI CONFIGURACIÓN? Sin llevarse nada (dueño, 2026-09-30: «revisa que no se pidan
+   * aprobaciones sin motivo»).
+   *
+   * El servicio lo pregunta al reconectarse, por si se perdió un aviso. Antes lo preguntaba
+   * pidiendo el cajón ENTERO —privadas incluidas— para sacarle una huella, y eso es un
+   * pedido de claves: a un servicio que pide aprobación le sonaba el teléfono al dueño en
+   * cada despliegue del proxio, para aprobar algo que no entregaba nada que el servicio no
+   * tuviera ya. La huella no revela nada, así que no se aprueba: quien pregunta tiene que
+   * ser igualmente el servicio de ese cajón (cert + CN del acta).
+   */
+  async function handleDigest (from, p) {
+    const ns = p.data?.ns
+    if (!isValidSecretsNs(ns)) return reply(from, { type: MSG.ERROR, error: 'digest: invalid namespace' })
+    const chk = await verifyChain({
+      data: p.data, signature: p.signature, cert: p.cert,
+      expectedScope: secretsScope(ns), ...(await contextoActa()), revoked: await revocationSet()
+    })
+    if (!chk.ok) return denyChain(from, chk, p, 'digest')
+    const record = (await identity.profileActa?.().catch(() => null))?.acta
+    if (!record || !Acta.memberCanReadSecrets(record, chk.device, ns)) {
+      audit('rejected', { what: 'digest', ns, reason: record ? 'cn' : 'sin-acta' })
+      return reply(from, { type: MSG.ERROR, error: `unauthorized: cn — the record does not recognise this member as the "${ns}" service` })
+    }
+    const body = { op: 'secrets.digest', ns, digest: drawerDigest(ns, chk.device), ts: Date.now() }
+    reply(from, { type: MSG.SECRETS_RESULT, body, seal: await sealOrFail(body), acta: record })
+  }
+
+  const storeNonces = new Map()
+  async function handleVarStore (from, p) {
+    const ns = p.data?.ns
+    const op = p.data?.op
+    if (!isValidSecretsNs(ns)) return reply(from, { type: MSG.ERROR, error: `${op}: invalid namespace` })
+    const chk = await verifyChain({
+      data: p.data, signature: p.signature, cert: p.cert,
+      expectedScope: secretsScope(ns), ...(await contextoActa()), revoked: await revocationSet()
+    })
+    if (!chk.ok) return denyChain(from, chk, p, op)
+    const record = (await identity.profileActa?.().catch(() => null))?.acta
+    if (!record || !Acta.memberCanReadSecrets(record, chk.device, ns)) {
+      audit('rejected', { what: op, ns, reason: record ? 'cn' : 'sin-acta' })
+      return reply(from, { type: MSG.ERROR, error: `unauthorized: cn — the record does not recognise this member as the "${ns}" service` })
+    }
+    const deviceId = await deviceIdOf(chk.device).catch(() => null)
+    // FIRMADA COMO TODO LO QUE SIRVE LA BÓVEDA (con la llave de sellado que nombra el acta, y
+    // el acta al lado): `store.recipients` dice PARA QUIÉN se sellan los valores, y si el
+    // proxio pudiera cambiar esa lista por sus llaves, abriría las privadas al pasar.
+    const answer = async (body) => reply(from, { type: MSG.SECRETS_RESULT, body, seal: await sealOrFail(body), acta: record })
+    try {
+      if (op === 'store.recipients') {
+        return await answer({
+          op: 'store.recipients', ns, ts: Date.now(),
+          recipients: { public: await varsDesk.recipients({ ns, public: true }), private: await varsDesk.recipients({ ns, public: false }) },
+          // Para que quien importa sepa de antemano qué va a pasar con lo que ya existe.
+          approval: hasApprover(record)
+        })
+      }
+      // CAMBIA ESTADO: un solo uso. La frescura (±5 min) no basta — repetir el mismo sobre
+      // dentro de esa ventana volvería a timbrar el teléfono de quien aprueba.
+      const nonce = p.data?.nonce
+      if (typeof nonce !== 'string' || nonce.length < 16) return reply(from, { type: MSG.ERROR, code: 'no-nonce', error: 'store: missing single-use nonce' })
+      const now = Date.now()
+      for (const [n, exp] of storeNonces) if (exp <= now) storeNonces.delete(n)
+      if (storeNonces.has(nonce)) { audit('rejected', { what: 'store', ns, reason: 'replay' }); return reply(from, { type: MSG.ERROR, code: 'replay', error: 'store: nonce already used' }) }
+      storeNonces.set(nonce, now + 10 * 60 * 1000)
+
+      const items = p.data?.items
+      if (!Array.isArray(items) || !items.length) return reply(from, { type: MSG.ERROR, error: 'store: needs `items`, each with its key and its sealed envelope' })
+      const result = await varsDesk.setMany({ ns, items, caller: chk.device, by: deviceId, fromService: true })
+      if (result?.pending) {
+        audit('store.pending', { device: deviceId, ns, id: result.pending, count: items.length })
+        log(`[vault] ${ns}: ${deviceId || '????-????'} wants to store ${items.length} variable(s) — waiting for approval (${result.pending})`)
+      } else {
+        audit('store', { device: deviceId, ns, keys: result?.keys || [] })
+        log(`[vault] ${ns}: ${deviceId || '????-????'} stored ${(result?.keys || []).length} variable(s) (nobody can approve: add only)`)
+        await notifyMembers('vars', { by: deviceId, keys: result?.keys || [], ns })
+      }
+      return await answer({ op: 'store.result', ns, ts: Date.now(), keys: result?.keys || [], pending: result?.pending || null })
+    } catch (e) {
+      return reply(from, { type: MSG.ERROR, ...(e.code ? { code: e.code } : {}), error: `${op}: ${e.message}` })
+    }
+  }
+
   async function handleSecrets (from, p) {
     if (!isFresh(p.data)) { audit('rejected', { what: 'secrets', reason: 'stale' }); return staleReply(from) }
     // REGISTRAR LA LLAVE DE CIFRADO de un servicio ya enrolado. Va por aquí, y no por
@@ -1433,6 +1556,8 @@ export async function startVault ({ dir = dataDir(), proxyUrl, log = console.log
     // da acceso a nada por sí solo. Quien firma esta petición ya tiene la llave de firma
     // del servicio y su cert, o sea que ya lee ese namespace. No hay escalada.
     if (p.data?.op === 'enckey') return handleEncKey(from, p)
+    if (p.data?.op === 'store.recipients' || p.data?.op === 'store') return handleVarStore(from, p)
+    if (p.data?.op === 'digest') return handleDigest(from, p)
     if (['approvals', 'approve', 'deny', 'grants', 'grant-revoke'].includes(p.data?.op)) return handleApproval(from, p)
     const ns = p.data?.ns
     if (!isValidSecretsNs(ns)) return reply(from, { type: MSG.ERROR, error: 'secrets: invalid namespace' })
@@ -1556,7 +1681,9 @@ export async function startVault ({ dir = dataDir(), proxyUrl, log = console.log
       }
     }
     const enc = await seal({ ek, payload })
-    const body = { op: 'secrets.result', ns, enc, ts: Date.now() }
+    // La huella va con cada entrega: es la referencia con la que el servicio compara después
+    // (`digest`) sin volver a pedir claves.
+    const body = { op: 'secrets.result', ns, enc, digest: drawerDigest(ns, devicePub), ts: Date.now() }
     // LA MAESTRA NO FIRMA ESTO. Su trabajo es sellar el acta y reenvolver sobres; servir
     // no es suyo. Quien firma es la LLAVE DE SELLADO que el acta nombra (`sealPub`), la
     // misma que ya firma cada sobre — y por eso esto se puede servir con el perfil
@@ -1734,7 +1861,10 @@ export async function startVault ({ dir = dataDir(), proxyUrl, log = console.log
    */
   async function notifyApprovers (pend, record) {
     try {
-      const body = { ev: 'approval', id: pend.id, ns: pend.ns, deviceId: pend.deviceId, label: pend.label, exp: pend.exp, ts: Date.now() }
+      // `kind` dice QUÉ se pide (llevarse claves, guardar variables, actualizar…): es lo que la
+      // app necesita para que el aviso diga el porqué sin tener que abrir la lista. Los
+      // detalles (comando, carpeta, nombres) NO van aquí: van sellados en la lista.
+      const body = { ev: 'approval', id: pend.id, ns: pend.ns, kind: pend.kind || 'read', deviceId: pend.deviceId, label: pend.label, exp: pend.exp, ts: Date.now() }
       const seal = await sealOrFail(body)
       const who = (record?.members || []).filter((m) => Acta.memberCan(record, m.pub, 'approve')).map((m) => m.pub)
       if (!who.length) log(`[vault] ${pend.ns}: nobody can approve (grant it with: dotrino-vault caps <ID> +aprueba)`)
@@ -2323,8 +2453,10 @@ export async function startVault ({ dir = dataDir(), proxyUrl, log = console.log
         // PÚBLICA Y PRIVADA VAN IGUAL (dueño, 2026-09-02: «la única diferencia es si se
         // despachan o no, son políticas; dales el mismo tratamiento de seguridad»). La
         // marca solo decide si se entrega sin aprobación.
+        // Si esto va a pedir aprobación, al aprobarse puede EDITAR; si no, solo añadir.
+        const ask = needsApproval(caller, await refreshActa())
         const apply = async () => {
-          await checkAuthor(owner, key, sealed, caller)
+          await checkAuthor(owner, key, sealed, caller, { allowOverwrite: ask })
           await checkRecipients(owner, sealed.wraps, !!isPublic)
           await secrets.putSealed(owner, key, sealed, { by: who, public: isPublic })
           audit('secret.set', { ns: ns || null, key, sealed: true }); scheduleNotice(ns)
@@ -2332,9 +2464,9 @@ export async function startVault ({ dir = dataDir(), proxyUrl, log = console.log
         }
         // Comprobado ANTES de dejarlo en espera: un sobre malo falla al guardarlo, no cinco
         // minutos después en la pantalla de quien aprueba. `apply` lo repite al aprobar.
-        await checkAuthor(owner, key, sealed, caller)
+        await checkAuthor(owner, key, sealed, caller, { allowOverwrite: ask })
         await checkRecipients(owner, sealed.wraps, !!isPublic)
-        const pending = await holdWrite({ caller, ns, pub, keys: [key], apply })
+        const pending = await holdWrite({ caller, ns, pub, keys: [key], apply, ask })
         if (pending) return { ok: true, key, pending }
         await apply()
         return { ok: true, key }
@@ -2362,7 +2494,7 @@ export async function startVault ({ dir = dataDir(), proxyUrl, log = console.log
      * Los NOMBRES también viajan dentro del sobre —no solo los valores—: el proxy
      * transporta y no tiene por qué aprender cómo se llama la configuración de un servicio.
      */
-    async setMany ({ ns, pub, items, caller = null, by: who = null }) {
+    async setMany ({ ns, pub, items, caller = null, by: who = null, fromService = false }) {
       // CADA VARIABLE VIENE EN SU PROPIO SOBRE, ya hecho. La bóveda no abre ninguno: solo
       // comprueba quién los firma y a quién envuelven, igual que en `set`. Aquí estaba el
       // `enc` que las traía todas juntas selladas AL PERFIL, y abrirlo era lo que obligaba
@@ -2370,16 +2502,24 @@ export async function startVault ({ dir = dataDir(), proxyUrl, log = console.log
       if (!Array.isArray(items) || !items.length) throw new Error('var.setMany: no variables came')
       const owner = ns ? `ns:${ns}` : `dev:${pub}`
       const keys = []
+      // ¿SE PIDE APROBACIÓN? Desde la mesa del admin, lo de siempre (`needsApproval`: quien
+      // tiene `unattended` escribe solo). Desde el propio SERVICIO que guarda en su cajón, se
+      // pide SIEMPRE que haya quien apruebe, tenga o no `unattended` (dueño, 2026-09-29:
+      // «el unattended también pediría aprobación»): `unattended` es para llevarse claves al
+      // arrancar, no para reescribir su propia configuración. Sin nadie que apruebe no se
+      // pide —la regla de siempre— y entonces solo puede añadir.
+      const record = await refreshActa()
+      const ask = fromService ? hasApprover(record) : needsApproval(caller, record)
       for (const it of items) {
         if (!it?.key || !it?.sealed) throw new Error('var.setMany: each variable needs its key and its sealed envelope')
-        await checkAuthor(owner, it.key, it.sealed, caller)
+        await checkAuthor(owner, it.key, it.sealed, caller, { allowOverwrite: ask })
         await checkRecipients(owner, it.sealed.wraps, !!it.public)
       }
       // Se comprueban TODAS antes de escribir NINGUNA: media carga aplicada es una
       // configuración que nadie quiso, y el servicio se reinicia con ella.
       const apply = async () => {
         for (const it of items) {
-          await checkAuthor(owner, it.key, it.sealed, caller)
+          await checkAuthor(owner, it.key, it.sealed, caller, { allowOverwrite: ask })
           await checkRecipients(owner, it.sealed.wraps, !!it.public)
         }
         for (const it of items) {
@@ -2389,7 +2529,7 @@ export async function startVault ({ dir = dataDir(), proxyUrl, log = console.log
         audit('secret.setMany', { ns: ns || null, keys }); scheduleNotice(ns)
         await settleDebts(owner)
       }
-      const pending = await holdWrite({ caller, ns, pub, keys: items.map((it) => it.key), apply })
+      const pending = await holdWrite({ caller, ns, pub, keys: items.map((it) => it.key), apply, ask })
       if (pending) return { ok: true, keys: [], pending }
       await apply()
       return { ok: true, keys }
@@ -2410,8 +2550,8 @@ export async function startVault ({ dir = dataDir(), proxyUrl, log = console.log
    *
    * Devuelve el id del pedido si la escritura quedó en espera, o `null` si se puede hacer ya.
    */
-  async function holdWrite ({ caller, ns, pub, keys, apply }) {
-    if (!needsApproval(caller, await refreshActa())) return null
+  async function holdWrite ({ caller, ns, pub, keys, apply, ask }) {
+    if (!(ask ?? needsApproval(caller, await refreshActa()))) return null
     // Quien llama ya comprobó el sobre; `apply` lo vuelve a comprobar al aprobar, porque el
     // acta pudo cambiar en medio.
     const target = ns || await deviceIdOf(pub).catch(() => null) || '?'
@@ -3062,7 +3202,7 @@ export async function startVault ({ dir = dataDir(), proxyUrl, log = console.log
    * relevo: alguien con `admin` colando un sobre que fabricó un tercero, sin que ninguna de
    * las dos comprobaciones lo note.
    */
-  async function checkAuthor (owner, key, sealed, caller) {
+  async function checkAuthor (owner, key, sealed, caller, { allowOverwrite = false } = {}) {
     const a = sealed?.author
     if (!a || typeof a.pub !== 'string' || typeof a.sig !== 'string' || typeof a.ts !== 'number') {
       throw new Error('var.set: the envelope must say WHO made it (`author: { pub, sig, ts }`)')
@@ -3088,12 +3228,17 @@ export async function startVault ({ dir = dataDir(), proxyUrl, log = console.log
     // un sobre existente; solamente el admin y el vault editan sobres, los otros pueden
     // crear los que faltan nomás»).
     //
+    // SALVO QUE ALGUIEN LO APRUEBE (dueño, 2026-09-29: «si requiere aprobación hagamos que
+    // pueda también editar; si no hay approval, solamente agregar — la aprobación nos da el
+    // nivel de seguridad aceptable»). Un sí de quien aprueba es justo la decisión humana que
+    // faltaba para reemplazar; sin él, sigue siendo solo rellenar.
+    //
     // Es la misma regla que `putWrap` («solo añade, nunca pisa») y por el mismo motivo: un
     // servicio que pudiera reemplazar un sobre podría dejar sin leer a otro miembro con uno
     // basura — denegación de servicio disfrazada de escritura. Rellenar lo que falta no
     // quita nada a nadie; reemplazar sí, y eso es de quien administra.
-    if (m.cn && secrets.has?.(owner, key)) {
-      throw new Error(`var.set: "${m.cn}" cannot overwrite "${key}" — a service only fills in what is missing; replacing is for who administers`)
+    if (m.cn && !allowOverwrite && secrets.has?.(owner, key)) {
+      throw Object.assign(new Error(`var.set: "${m.cn}" cannot overwrite "${key}" — without an approval a service only fills in what is missing; replacing is for who administers`), { code: 'exists' })
     }
     const cuerpo = authorBody(owner, key, sealed.e, a.ts)
     if (!(await verifyDeviceSig({ publickey: a.pub, data: cuerpo, signature: a.sig }))) {