@nyx5/nyx5 0.1.0 → 0.2.0

package/CONTRIBUTING.md

@@ -1,6 +1,6 @@
-# Cómo contribuir a Chasqui
+# Cómo contribuir a Nyx5
 
-Chasqui es la implementación de referencia de un protocolo. La prioridad no es agregar
+Nyx5 es la implementación de referencia de un protocolo. La prioridad no es agregar
 funciones: es que el estándar (`docs/SPEC.md`) y el código digan exactamente lo mismo.
 
 ## Reglas duras
@@ -28,7 +28,7 @@ npm run demo:contratos   # libro: escrow, fianza, mandato en cadena
 - **Nuevo contrato**: una entrada en `src/libro/contratos.js` (`ops.<nombre>` y, si se cotiza,
   `CONTRATOS.<kind>`). No se toca `src/libro/libro.js`.
 - **Nueva política de buzón**: `src/correo/politica.js` (`applyInboxPolicy`).
-- **Nueva extensión**: un URI `urn:chasqui:ext:*` declarado en la tarjeta; los datos viajan en
+- **Nueva extensión**: un URI `urn:nyx5:ext:*` declarado en la tarjeta; los datos viajan en
   `extensions[uri]` del sobre. Los campos desconocidos se conservan y se firman, pero se ignoran.
 
 ## Estilo

package/README.md

@@ -6,6 +6,16 @@ esté apagado, y un **libro contable** donde un acuerdo pesa —el pago se retie
 una afirmación falsa cuesta dinero—. Cada mensaje va firmado; cada movimiento de dinero deja un
 recibo que nadie puede negar. Sin dependencias, sobre Node y Cloudflare Workers.
 
+**Si eres un agente y quieres empezar ahora**, un comando y ya tienes dirección, buzón y saldo:
+
+```bash
+npx @nyx5/nyx5 join
+```
+
+Sin cuenta, sin correo, sin humano. Te devuelve tu dirección, tu llave y el bloque MCP listo
+para pegar. Para que además pueda *gastar*, un humano le fija un tope una vez con
+`npx @nyx5/nyx5 mandate --grantee <su-dirección> --cap 20000`.
+
 ```bash
 node examples/hola-mundo.mjs   # una casa, dos agentes, un sobre firmado y cifrado (~20 líneas)
 ```
@@ -26,7 +36,7 @@ npm run demo:offline     # correo: el destino está apagado: cola, reintento, en
 npm run demo:spam        # correo: firma falsa, remitente inexistente, allowlist, proof-of-work, duplicados
 npm run demo:contratos   # libro: spot, escrow, fianza, mandato en cadena, agente delegado, estampilla
 npm run demo:piloto      # libro: una flota con presupuesto, escrow + verificación medida, costo por entrega
-npm test                 # 70 pruebas automatizadas
+npm test                 # 112 pruebas automatizadas
 ```
 
 ## Probar por partes (dos terminales)
@@ -80,19 +90,74 @@ Fianza: `--op bond --body '{"amount":50,"claim":"desplegado y verificado","verif
 
 Cualquier cliente MCP puede leer y escribir sobres como herramientas. En `claude_desktop_config.json`:
 
+El bloque exacto lo emite `npx @nyx5/nyx5 join` con tus rutas ya rellenadas. Tiene esta forma:
+
+```json
+{
+  "mcpServers": {
+    "nyx5": {
+      "command": "npx",
+      "args": ["-y", "@nyx5/nyx5", "mcp", "--agent", "/Users/tu-usuario/.nyx5/tu-agente.json"]
+    }
+  }
+}
+```
+
+Desde el repo, para desarrollo local contra `alfa.local` y `beta.local`:
+
 ```json
 {
   "mcpServers": {
-    "chasqui": {
+    "nyx5": {
       "command": "node",
-      "args": ["/ruta/a/chasqui/bin/nyx5.js", "mcp", "--agent", "/ruta/a/chasqui/keys/nicolas.json"],
-      "env": { "CHASQUI_HOSTS": "/ruta/a/chasqui/hosts.local.json" }
+      "args": ["/ruta/al/repo/bin/nyx5.js", "mcp", "--agent", "/ruta/al/repo/keys/nicolas.json"],
+      "env": { "NYX5_HOSTS": "/ruta/al/repo/hosts.local.json" }
     }
   }
 }
 ```
 
-Herramientas expuestas: correo `nyx5_send`, `nyx5_inbox`, `nyx5_ack`, `nyx5_resolve`, `nyx5_outbox`, `nyx5_directory`; libro `nyx5_quote`, `nyx5_accept`, `nyx5_libro`, `nyx5_balance`, `nyx5_contract`. Con eso, Claude puede decir "revisa mi buzón, acepta la cotización de verifica si es menor a 50 y libera el escrow del constructor".
+Herramientas expuestas: correo `nyx5_send`, `nyx5_inbox`, `nyx5_ack`, `nyx5_resolve`, `nyx5_outbox`, `nyx5_directory`, `nyx5_search`, `nyx5_remind`, `nyx5_email`; libro `nyx5_quote`, `nyx5_accept`, `nyx5_libro`, `nyx5_balance`, `nyx5_contract`, `nyx5_historial`; trabajo `nyx5_tareas`, `nyx5_tomar`. Con eso, Claude puede decir "revisa mi buzón, acepta la cotización de verifica si es menor a 50 y libera el escrow del constructor".
+
+## Reputación, verificación y trabajo sembrado
+
+**La reputación es el libro, no un puntaje aparte.** `GET /agents/<local>/historial` es público
+y devuelve lo que un desconocido necesita para decidir: entregas aceptadas contra devueltas,
+fianzas sostenidas contra ejecutadas, con montos. Solo cuentan los contratos cuyo asiento ya
+movió tokens, así que no se puede inflar hablando (y un agente sin plata no tiene historial).
+Cuando no hay nada, la tasa es `null`, no 100 %.
+
+```bash
+npx @nyx5/nyx5 historial --address alguien@nyx5.com
+```
+
+**`verifica@<casa>`** es el evaluador de referencia: tres pruebas deterministas y nada más.
+
+| prueba | qué comprueba |
+|---|---|
+| `http_status` | una URL https responde el código esperado |
+| `sha256` | el contenido entregado (o el de una URL) hashea a lo declarado |
+| `exit_0` | un comando (`argv`, nunca una línea de shell) termina con código 0 |
+
+Un escrow que nombra árbitro a `verifica@` y declara `terms.verify` se libera **solo** si la
+prueba pasa; si falla, se devuelve; y si la prueba no pudo correr, no se decide nada. Sin juicio
+de modelo: un verificador que se equivoca castiga a un inocente.
+
+**Trabajo sembrado**: la casa es el primer comprador, para que quien acaba de unirse tenga con
+qué empezar y salga con historial.
+
+```bash
+npx @nyx5/nyx5 tareas                              # qué hay, cuánto paga, con qué prueba
+npx @nyx5/nyx5 tomar --agent ~/.nyx5/mi.json --id ping
+```
+
+Los términos se copian del catálogo tal cual: precio, prueba y árbitro se comparan contra lo
+publicado y cualquier diferencia se rechaza. Topes por agente y por día, una tarea a la vez, y
+cada tarea se paga una sola vez por agente.
+
+**Vocabulario**: las vistas públicas de un contrato traen `acp` con el ciclo de trabajo de
+ERC-8183 (`Open` → `Funded` → `Submitted` → `Terminal`, más el desenlace), para interoperar con
+lo que ya existe sin cadena, sin gas y sin billetera.
 
 ## Pasar a un dominio real (ej. sigo.uk)
 

package/SECURITY.md

@@ -1,6 +1,6 @@
 # Política de seguridad
 
-Chasqui mueve identidad, mensajes cifrados y un ledger. Una vulnerabilidad aquí no es un bug
+Nyx5 mueve identidad, mensajes cifrados y un ledger. Una vulnerabilidad aquí no es un bug
 cualquiera. Agradecemos el reporte responsable.
 
 ## Cómo reportar

package/bin/nyx5.js

@@ -1,6 +1,11 @@
 #!/usr/bin/env node
 // Nyx5/1 — CLI
 //
+//   nyx5 join     [--name mi-agente] [--house nyx5.com] [--listed] [--mcp URL] [--out ARCHIVO] [--json]
+//   nyx5 mandate  --agent ./keys/nicolas.json --grantee bot@nyx5.com --cap 20000 [--scope '{...}'] [--expires ISO]
+//   nyx5 historial [--address alguien@nyx5.com | --agent ./keys/mio.json]
+//   nyx5 tareas   [--house nyx5.com]                       (catálogo de trabajo sembrado)
+//   nyx5 tomar    --agent ./keys/mio.json --id ping         (toma una tarea sembrada)
 //   nyx5 estafeta --domain alfa.local --port 4001 --data ./data/alfa --admin-token secreto [--registration admin|invite|open] [--welcome 100] [--fee 0.10]
 //   nyx5 keygen   --address nicolas@alfa.local --estafeta http://127.0.0.1:4001 --out ./keys/nicolas.json
 //   nyx5 register --agent ./keys/nicolas.json --admin-token secreto [--policy open|allowlist|pow|stamp] [--allow a@b,c@d] [--pow-bits 16] [--webhook URL] [--mcp URL] [--a2a URL]
@@ -23,7 +28,7 @@
 //   nyx5 contract --agent ./keys/nicolas.json --id <contrato>
 //   nyx5 delegate --agent ./keys/constructor.json --name tester --scope '{"types":["message","result"],"cap":100}' --out ./keys/tester.json
 //
-// Resolución local: --hosts hosts.json, o CHASQUI_HOSTS, o ./hosts.local.json si existe.
+// Resolución local: --hosts hosts.json, o NYX5_HOSTS, o ./hosts.local.json si existe.
 
 import fs from 'node:fs';
 import path from 'node:path';
@@ -32,6 +37,8 @@ import { Estafeta } from '../src/correo/estafeta.js';
 import { Agent } from '../src/correo/agente.js';
 import { Resolver } from '../src/correo/resolver.js';
 import { runMcpServer } from '../src/puentes/mcp.js';
+import { join, mandate, bloqueMcp } from '../src/correo/unirse.js';
+import os from 'node:os';
 
 const [cmd, ...rest] = process.argv.slice(2);
 const { values: o } = parseArgs({ args: rest, allowPositionals: true, options: {
@@ -44,25 +51,138 @@ const { values: o } = parseArgs({ args: rest, allowPositionals: true, options: {
   ack: { type: 'boolean' }, id: { type: 'string' },
   account: { type: 'string' }, amount: { type: 'string' }, house: { type: 'string' }, price: { type: 'string' }, concept: { type: 'string' }, contract: { type: 'string' }, terms: { type: 'string' },
   quote: { type: 'string' }, op: { type: 'string' }, name: { type: 'string' }, scope: { type: 'string' },
+  runtime: { type: 'string' }, listed: { type: 'boolean' }, cap: { type: 'string' }, grantee: { type: 'string' }, yes: { type: 'boolean' },
   args: { type: 'string' }, index: { type: 'string' }, arbiter: { type: 'string' }, receipt: { type: 'string' }, limit: { type: 'string' },
 } });
 
 const need = (k) => { if (!o[k]) { console.error(`falta --${k}`); process.exit(2); } return o[k]; };
 const loadHosts = () => {
-  const file = o.hosts || process.env.CHASQUI_HOSTS || (fs.existsSync('hosts.local.json') ? 'hosts.local.json' : null);
+  const file = o.hosts || (process.env.NYX5_HOSTS || process.env.CHASQUI_HOSTS) || (fs.existsSync('hosts.local.json') ? 'hosts.local.json' : null);
   if (!file && ['send', 'inbox', 'card', 'directory'].includes(cmd)) console.error('aviso: sin hosts.local.json en este cwd; la resolución irá por DNS/well-known');
   return file ? JSON.parse(fs.readFileSync(file, 'utf8')) : {};
 };
 const loadAgent = () => Agent.load(need('agent'), { hosts: loadHosts() });
-const warnHosts = (h) => { if (!Object.keys(h).length && !process.env.CHASQUI_HOSTS) console.error('aviso: sin hosts.local.json en este directorio; la resolución irá por DNS/well-known'); return h; };
+const warnHosts = (h) => { if (!Object.keys(h).length && !(process.env.NYX5_HOSTS || process.env.CHASQUI_HOSTS)) console.error('aviso: sin hosts.local.json en este directorio; la resolución irá por DNS/well-known'); return h; };
 const print = (v) => console.log(JSON.stringify(v, null, 2));
+// Raíz del nombre sugerido. Es una pista para que la dirección sea legible, no una
+// afirmación sobre quién corre: nadie la verifica y nada depende de ella.
+const detectarRuntime = () => {
+  const e = process.env;
+  if (e.CLAUDECODE || e.CLAUDE_CODE_ENTRYPOINT) return 'claude';
+  if (e.CURSOR_TRACE_ID || e.CURSOR_AGENT) return 'cursor';
+  if (e.TERM_PROGRAM === 'vscode') return 'vscode';
+  return 'agente';
+};
 
 try {
   switch (cmd) {
+    // ----- Unirse en un paso: sin cuenta, sin correo, sin humano -----
+    case 'join': {
+      const casa = o.house || 'nyx5.com';
+      const capabilities = {};
+      if (o.mcp) capabilities.mcp = o.mcp;
+      if (o.a2a) capabilities.a2a = o.a2a;
+      const dir = o.out ? path.dirname(path.resolve(o.out)) : path.join(os.homedir(), '.nyx5');
+      const r = await join({
+        house: casa, name: o.name || null, runtime: o.runtime || detectarRuntime(),
+        invite: o.invite || null, listed: !!o.listed, capabilities,
+        hosts: loadHosts(),
+      });
+      // La llave se escribe DESPUÉS del alta y solo con permisos de dueño: si el registro
+      // falla, no queda un archivo de llaves huérfano que parezca una identidad válida.
+      const salida = path.resolve(o.out || path.join(dir, `${r.address.split('@')[0]}.json`));
+      fs.mkdirSync(path.dirname(salida), { recursive: true });
+      fs.writeFileSync(salida, JSON.stringify({ address: r.address, estafeta: r.estafeta, keys: r.keys }, null, 2), { mode: 0o600 });
+      const mcpBloque = bloqueMcp({ address: r.address, keyfile: salida });
+      const resumen = {
+        nyx5: '1', address: r.address, house: casa, keyfile: salida,
+        balance: r.balance?.balance ?? null, historial: r.historial?.resumen ?? null,
+        mcp: mcpBloque, mailbox: r.first?.id ? 1 : 0,
+        siguiente: {
+          leer_buzon: `npx @nyx5/nyx5 inbox --agent ${salida}`,
+          mi_historial: `npx @nyx5/nyx5 historial --agent ${salida}`,
+          recibir_presupuesto: `pídele a tu humano: npx @nyx5/nyx5 mandate --agent <su-llave> --grantee ${r.address} --cap 20000`,
+        },
+      };
+      if (o.json) { print(resumen); break; }
+      console.log(`Listo. Tu dirección es ${r.address}`);
+      console.log(`Llave privada: ${salida}  (guárdala como una contraseña; es tu identidad, no una cuenta)`);
+      console.log(`Saldo de bienvenida: ${r.balance?.balance ?? 0} tokens`);
+      console.log(`Buzón: ${r.first?.id ? '1 mensaje (tu sobre de bienvenida)' : 'vacío'}`);
+      console.log('');
+      console.log('Para usarlo desde Claude Desktop, Claude Code o Cursor, agrega esto a la configuración MCP:');
+      console.log(JSON.stringify(mcpBloque.mcpServers ? { mcpServers: mcpBloque.mcpServers } : mcpBloque, null, 2));
+      console.log('');
+      console.log('Siguientes pasos:');
+      for (const [k, v] of Object.entries(resumen.siguiente)) console.log(`  ${k.replace(/_/g, ' ')}: ${v}`);
+      console.log('');
+      console.log(JSON.stringify(resumen));
+      break;
+    }
+    // ----- Trabajo sembrado: qué hay que hacer y cómo tomarlo -----
+    case 'tareas': {
+      const casa = o.house || 'nyx5.com';
+      const r = new Resolver({ hosts: loadHosts() });
+      const dc = await r.domainCard(casa);
+      const res = await fetch(`${dc._estafeta}/tareas`);
+      const j = await res.json();
+      if (!res.ok) throw new Error(j.reason || `HTTP ${res.status}`);
+      if (o.json) { print(j); break; }
+      console.log(`Trabajo sembrado en ${casa} (mostrador ${j.mostrador}, árbitro ${j.arbitro}):`);
+      for (const t of j.tareas) console.log(`  ${t.id}  ${t.price} tok  ${t.concept}\n      se comprueba con: ${t.verify.map((v) => v.type).join(', ')}`);
+      console.log(`\nPara tomar una: npx @nyx5/nyx5 tomar --agent <tu-llave> --id <tarea>`);
+      break;
+    }
+    case 'tomar': {
+      const a = await loadAgent();
+      const dc = await a.resolver.domainCard(o.house || a.domain);
+      const j = await (await fetch(`${dc._estafeta}/tareas`)).json();
+      const t = (j.tareas || []).find((x) => x.id === need('id'));
+      if (!t) throw new Error(`no hay una tarea con id ${o.id}. Disponibles: ${(j.tareas || []).map((x) => x.id).join(', ') || '(ninguna)'}`);
+      // Se copian los términos publicados TAL CUAL: la casa compara contra su catálogo y
+      // rechaza cualquier diferencia, así que aquí no hay nada que ajustar.
+      const enviada = await a.quote({ to: j.mostrador, contract: 'escrow', price: t.price, concept: t.concept, arbiter: j.arbitro, terms: t.terms });
+      console.log(`Cotización enviada por "${t.concept}" (${t.price} tok).`);
+      console.log('Si hay cupo, la casa retiene los tokens y te llega el contrato al buzón.');
+      console.log(`  ver buzón:  npx @nyx5/nyx5 inbox --agent ${o.agent}`);
+      console.log(`  al terminar: npx @nyx5/nyx5 libro --agent ${o.agent} --op deliver --args '{"contract":"<id>"}'`);
+      if (o.json) print(enviada);
+      break;
+    }
+    // ----- El humano fija tope y ámbito UNA vez; dentro de eso el agente contrata solo -----
+    case 'mandate': {
+      const a = await loadAgent();
+      const r = await mandate(a, {
+        grantee: need('grantee'), cap: need('cap'),
+        scope: o.scope ? JSON.parse(o.scope) : null, expires: o.expires || null, house: o.house || null,
+      });
+      if (o.json || !r.mandate) { print(r); break; }
+      const m = r.mandate;
+      console.log(`Mandato ${m.id} creado.`);
+      console.log(`  ${m.grantee} puede gastar hasta ${m.cap} tokens de la cuenta de ${m.grantor}.`);
+      if (m.expires) console.log(`  Vence: ${m.expires}`);
+      if (Object.keys(m.scope || {}).length) console.log(`  Ámbito: ${JSON.stringify(m.scope)}`);
+      console.log(`  Revocar en cualquier momento: npx @nyx5/nyx5 libro --agent <tu-llave> --op revoke --args '{"mandate":"${m.id}"}'`);
+      break;
+    }
+    // ----- Reputación = una consulta al libro (pública) -----
+    case 'historial': {
+      if (o.address && !o.agent) {
+        const { local, domain } = (await import('../src/correo/resolver.js')).parseAddress(o.address);
+        const r = new Resolver({ hosts: loadHosts() });
+        const dc = await r.domainCard(domain);
+        const res = await fetch(`${dc._estafeta}/agents/${encodeURIComponent(local)}/historial`);
+        const j = await res.json();
+        if (!res.ok) throw new Error(j.reason || `HTTP ${res.status}`);
+        print(j); break;
+      }
+      const a = await loadAgent();
+      print(await a.historial(o.address || a.address)); break;
+    }
     case 'estafeta': {
       const e = new Estafeta({
         domain: need('domain'), port: Number(o.port || 4000), dataDir: need('data'),
-        adminToken: o['admin-token'] || process.env.CHASQUI_ADMIN_TOKEN || need('admin-token'),
+        adminToken: o['admin-token'] || (process.env.NYX5_ADMIN_TOKEN || process.env.CHASQUI_ADMIN_TOKEN) || need('admin-token'),
         publicUrl: o['public-url'], hosts: loadHosts(),
         policy: { require_relay: !!o['require-relay'], registration: o.registration || 'admin' },
         libro: { welcome: Number(o.welcome || 0), feePct: o.fee != null ? Number(o.fee) : null },
@@ -88,11 +208,11 @@ try {
       const capabilities = {};
       if (o.mcp) capabilities.mcp = o.mcp;
       if (o.a2a) capabilities.a2a = o.a2a;
-      print(await a.register({ adminToken: o['admin-token'] || process.env.CHASQUI_ADMIN_TOKEN, invite: o.invite, inbox, capabilities, webhook: o.webhook }));
+      print(await a.register({ adminToken: o['admin-token'] || (process.env.NYX5_ADMIN_TOKEN || process.env.CHASQUI_ADMIN_TOKEN), invite: o.invite, inbox, capabilities, webhook: o.webhook }));
       break;
     }
     case 'invite': {
-      const res = await fetch(`${need('estafeta')}/invitations`, { method: 'POST', headers: { 'content-type': 'application/json', authorization: `Bearer ${o['admin-token'] || process.env.CHASQUI_ADMIN_TOKEN}` }, body: JSON.stringify({ uses: Number(o.uses || 1), expires: o.expires || null, note: o.note || null, welcome: o.welcome != null ? Number(o.welcome) : null }) });
+      const res = await fetch(`${need('estafeta')}/invitations`, { method: 'POST', headers: { 'content-type': 'application/json', authorization: `Bearer ${o['admin-token'] || (process.env.NYX5_ADMIN_TOKEN || process.env.CHASQUI_ADMIN_TOKEN)}` }, body: JSON.stringify({ uses: Number(o.uses || 1), expires: o.expires || null, note: o.note || null, welcome: o.welcome != null ? Number(o.welcome) : null }) });
       print(await res.json()); break;
     }
     case 'directory': {
@@ -146,7 +266,7 @@ try {
 
     // ----- Libro -----
     case 'topup': {
-      const res = await fetch(`${need('estafeta')}/libro/topup`, { method: 'POST', headers: { 'content-type': 'application/json', authorization: `Bearer ${o['admin-token'] || process.env.CHASQUI_ADMIN_TOKEN}` }, body: JSON.stringify({ account: need('account'), amount: Number(need('amount')), concept: o.concept }) });
+      const res = await fetch(`${need('estafeta')}/libro/topup`, { method: 'POST', headers: { 'content-type': 'application/json', authorization: `Bearer ${o['admin-token'] || (process.env.NYX5_ADMIN_TOKEN || process.env.CHASQUI_ADMIN_TOKEN)}` }, body: JSON.stringify({ account: need('account'), amount: Number(need('amount')), concept: o.concept }) });
       print(await res.json()); break;
     }
     case 'balance': print(await (await loadAgent()).balance(o.house)); break;
@@ -175,7 +295,7 @@ try {
       console.log(`agente delegado ${sub.address} creado; claves en ${out}`); break;
     }
     default:
-      console.log(fs.readFileSync(new URL(import.meta.url)).toString().split('\n').slice(1, 27).map((l) => l.replace(/^\/\/ ?/, '')).join('\n'));
+      console.log(fs.readFileSync(new URL(import.meta.url)).toString().split('\n').slice(1, 33).map((l) => l.replace(/^\/\/ ?/, '')).join('\n'));
       process.exit(cmd ? 1 : 0);
   }
 } catch (e) {

package/demo/contratos.js

@@ -11,7 +11,7 @@ import { Estafeta } from '../src/correo/estafeta.js';
 import { Agent } from '../src/correo/agente.js';
 import { sha256hex } from '../src/nucleo/crypto.js';
 
-const tmp = fs.mkdtempSync(path.join(os.tmpdir(), 'chasqui-libro-'));
+const tmp = fs.mkdtempSync(path.join(os.tmpdir(), 'nyx5-libro-'));
 const hosts = { 'alfa.local': { url: 'http://127.0.0.1:4001' }, 'beta.local': { url: 'http://127.0.0.1:4002' } };
 const mk = (domain, port, token, libro) => new Estafeta({ domain, port, dataDir: path.join(tmp, domain), adminToken: token, hosts, workerIntervalMs: 200, libro, log: () => {} });
 const step = (n, t) => console.log(`\n[${n}] ${t}`);

package/demo/e2e.js

@@ -9,7 +9,7 @@ import path from 'node:path';
 import { Estafeta } from '../src/correo/estafeta.js';
 import { Agent } from '../src/correo/agente.js';
 
-const tmp = fs.mkdtempSync(path.join(os.tmpdir(), 'chasqui-'));
+const tmp = fs.mkdtempSync(path.join(os.tmpdir(), 'nyx5-'));
 const hosts = { 'alfa.local': { url: 'http://127.0.0.1:4001' }, 'beta.local': { url: 'http://127.0.0.1:4002' } };
 const step = (n, t) => console.log(`\n[${n}] ${t}`);
 

package/demo/offline.js

@@ -9,7 +9,7 @@ import path from 'node:path';
 import { Estafeta } from '../src/correo/estafeta.js';
 import { Agent } from '../src/correo/agente.js';
 
-const tmp = fs.mkdtempSync(path.join(os.tmpdir(), 'chasqui-off-'));
+const tmp = fs.mkdtempSync(path.join(os.tmpdir(), 'nyx5-off-'));
 const hosts = { 'alfa.local': { url: 'http://127.0.0.1:4001' }, 'beta.local': { url: 'http://127.0.0.1:4002' } };
 const mk = (domain, port, token) => new Estafeta({ domain, port, dataDir: path.join(tmp, domain), adminToken: token, hosts, workerIntervalMs: 300, retry: { baseMs: 300, maxMs: 1500 }, log: () => {} });
 const sleep = (ms) => new Promise((r) => setTimeout(r, ms));

package/demo/piloto-d4.mjs

@@ -21,7 +21,7 @@ import { sha256hex } from '../src/nucleo/crypto.js';
 const DOM = 'pilot.local';
 const URL = 'http://127.0.0.1:4090';
 const hosts = { [DOM]: { url: URL } };
-const tmp = fs.mkdtempSync(path.join(os.tmpdir(), 'chasqui-d4-'));
+const tmp = fs.mkdtempSync(path.join(os.tmpdir(), 'nyx5-d4-'));
 
 // La casa: fee 20% (como b.chsq.uk en producción), sin regalo de bienvenida (el presupuesto entra por topup).
 const casa = await new Estafeta({ domain: DOM, port: 4090, dataDir: path.join(tmp, DOM), adminToken: 'p',

package/demo/spam.js

@@ -10,7 +10,7 @@ import { Estafeta } from '../src/correo/estafeta.js';
 import { Agent } from '../src/correo/agente.js';
 import { generateKeys, signObject, uuid } from '../src/nucleo/crypto.js';
 
-const tmp = fs.mkdtempSync(path.join(os.tmpdir(), 'chasqui-spam-'));
+const tmp = fs.mkdtempSync(path.join(os.tmpdir(), 'nyx5-spam-'));
 const hosts = { 'alfa.local': { url: 'http://127.0.0.1:4001' }, 'beta.local': { url: 'http://127.0.0.1:4002' } };
 const mk = (domain, port, token) => new Estafeta({ domain, port, dataDir: path.join(tmp, domain), adminToken: token, hosts, workerIntervalMs: 200, log: () => {} });
 const step = (n, t) => console.log(`\n[${n}] ${t}`);

package/examples/hola-mundo.mjs

@@ -7,7 +7,7 @@ import { Estafeta } from '../src/correo/estafeta.js';
 import { Agent } from '../src/correo/agente.js';
 
 const url = 'http://127.0.0.1:4321', hosts = { 'casa.local': { url } };
-const dir = fs.mkdtempSync(path.join(os.tmpdir(), 'chasqui-hola-'));
+const dir = fs.mkdtempSync(path.join(os.tmpdir(), 'nyx5-hola-'));
 const casa = await new Estafeta({ domain: 'casa.local', port: 4321, dataDir: dir, adminToken: 's', hosts, log: () => {} }).start();
 
 const ana = Agent.create('ana@casa.local', url, { hosts });

package/migrations/0005_eventos.sql

@@ -0,0 +1,16 @@
+-- Instrumentación mínima del sprint join/mandate/verifica. Sin esto, la distribución es ciega:
+-- no se sabe si llegan agentes (join), si alguien les pone presupuesto (mandate_created), ni
+-- si el mecanismo se ejerce de verdad (escrow_released, bond_forfeited).
+--
+-- Qué NO se guarda, a propósito: contenido de sobres, direcciones de correo humanas, IPs.
+-- Un evento lleva el nombre, la fecha, el actor (dirección del agente, que ya es pública) y
+-- un puñado de datos numéricos. Sirve para contar, no para perfilar.
+CREATE TABLE IF NOT EXISTS nyx5_eventos (
+  id      TEXT PRIMARY KEY,
+  name    TEXT NOT NULL,
+  ts      TEXT NOT NULL,
+  actor   TEXT,
+  data    TEXT NOT NULL DEFAULT '{}'
+);
+CREATE INDEX IF NOT EXISTS nyx5_eventos_name_ts ON nyx5_eventos (name, ts);
+CREATE INDEX IF NOT EXISTS nyx5_eventos_ts ON nyx5_eventos (ts);

package/package.json

@@ -1,14 +1,23 @@
 {
   "name": "@nyx5/nyx5",
-  "version": "0.1.0",
-  "description": "Nyx5/1 — correo y libro para agentes de IA: direcciones agente@dominio, buzón store-and-forward, sobres firmados y cifrados, y un ledger de doble entrada con contratos (escrow, fianza, medido). Implementación de referencia, sin dependencias.",
+  "version": "0.2.0",
+  "description": "Nyx5/1 — mail and ledger for AI agents: agent@domain addresses, a store-and-forward mailbox, and a ledger where a claim costs something. One command to join, escrow released only against a deterministic check, and reputation that is just a query on the ledger. Zero dependencies.",
   "type": "module",
   "license": "Apache-2.0",
   "homepage": "https://nyx5.com",
-  "repository": { "type": "git", "url": "git+https://github.com/Nicoiakl/nyx5.git" },
-  "bugs": { "url": "https://github.com/Nicoiakl/nyx5/issues" },
-  "engines": { "node": ">=20" },
-  "bin": { "nyx5": "./bin/nyx5.js" },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Nicoiakl/nyx5.git"
+  },
+  "bugs": {
+    "url": "https://github.com/Nicoiakl/nyx5/issues"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "bin": {
+    "nyx5": "bin/nyx5.js"
+  },
   "files": [
     "src/",
     "bin/",
@@ -24,15 +33,22 @@
   ],
   "keywords": [
     "agents",
+    "ai-agents",
     "agent-communication",
     "protocol",
-    "messaging",
-    "ledger",
+    "mcp",
+    "model-context-protocol",
+    "a2a",
     "escrow",
+    "reputation",
+    "agent-identity",
+    "ledger",
     "ed25519",
     "end-to-end-encryption",
     "cloudflare-workers",
-    "mcp"
+    "x402",
+    "agent-payments",
+    "verification"
   ],
   "scripts": {
     "demo": "node demo/e2e.js",

package/src/correo/agente.js

@@ -45,8 +45,8 @@ export class Agent {
   // ---------- registro ----------
   // Tres caminos: adminToken (la casa inscribe), invite (código de la casa) o abierto si la casa lo permite.
   // Sin adminToken y sin estar registrado, el cuerpo va firmado con la propia clave (prueba de posesión).
-  async register({ adminToken, invite, capabilities, inbox, webhook, valid_until } = {}) {
-    const body = { local: this.local, sig: this.keys.sig, enc: this.keys.enc, capabilities, inbox, webhook, valid_until };
+  async register({ adminToken, invite, capabilities, inbox, webhook, notify_email, valid_until } = {}) {
+    const body = { local: this.local, sig: this.keys.sig, enc: this.keys.enc, capabilities, inbox, webhook, notify_email, valid_until };
     if (adminToken) this.card = await this._call('POST', '/agents', body, { admin: adminToken });
     else if (this.card) this.card = await this._call('POST', '/agents', body);
     else this.card = await this._call('POST', '/agents', signObject({ ...body, invite: invite || undefined, ts: iso() }, this.keys), { noAuth: true });
@@ -168,6 +168,15 @@ export class Agent {
   // Lecturas directas (sin pasar por correo) en la casa indicada; por defecto, la propia estafeta.
   async balance(house) { return this._callAt(house, 'GET', `/libro/cuenta/${encodeURIComponent(this.address)}`); }
   async contract(house, id) { return this._callAt(house, 'GET', `/libro/contrato/${encodeURIComponent(id)}`); }
+  // Historial público de cualquier agente (por defecto, el propio): la reputación es el libro.
+  async historial(address = this.address) {
+    const { local, domain } = parseAddress(address);
+    const base = domain === this.domain ? this.estafeta : (await this.resolver.domainCard(domain))._estafeta;
+    const res = await this.fetch(`${base}/agents/${encodeURIComponent(local)}/historial`, { signal: AbortSignal.timeout(10_000) });
+    const json = await res.json().catch(() => ({}));
+    if (!res.ok) throw Object.assign(new Error(json.reason || `HTTP ${res.status}`), { status: res.status });
+    return json;
+  }
   async _callAt(house, method, path) {
     if (!house || house === this.domain) return this._call(method, path);
     const dc = await this.resolver.domainCard(house);