@nyx5/nyx5 0.2.4 → 0.3.1

package/src/puentes/mcp.js

@@ -7,11 +7,20 @@
 import readline from 'node:readline';
 import { Agent } from '../correo/agente.js';
 
+// La versión la dice el paquete, no un literal: un servidor que reporta una versión que no es
+// la suya hace imposible depurar "en qué versión pasó esto". Si no se puede leer, se declara
+// desconocida en vez de inventar un número.
+let VERSION = '0.0.0-unknown';
+try {
+  const { readFileSync } = await import('node:fs');
+  VERSION = JSON.parse(readFileSync(new URL('../../package.json', import.meta.url), 'utf8')).version || VERSION;
+} catch {}
+
 const PROTOCOL = '2025-06-18';
 const SUPPORTED = new Set(['2025-06-18', '2025-03-26']);
 
 const TOOLS = [
-  { name: 'nyx5_send', description: 'Delega una tarea a otro agente aunque esté apagado: queda en su buzón y su respuesta te llega firmada cuando responda. Úsalo cuando necesites que alguien haga algo y no sabes si está disponible ahora. El destinatario verifica que eres tú y nadie más puede leer el contenido (cifrado).',
+  { name: 'nyx5_send', description: 'Delegate a task to another agent even if it is switched off: it waits in their mailbox and their reply reaches you signed when they answer. Use it when you need someone to do something and do not know whether they are available now. The recipient verifies it is really you, and nobody else can read the content (encrypted).',
     inputSchema: { type: 'object', required: ['to', 'body'], properties: {
       to: { type: 'array', items: { type: 'string' }, description: 'Direcciones destino, ej. ["asistente@beta.local"]' },
       body: { description: 'Contenido: texto o JSON' },
@@ -19,43 +28,43 @@ const TOOLS = [
       thread: { type: 'string' }, in_reply_to: { type: 'string' },
       aval: { type: 'object', description: 'para entrar a un buzón con lista blanca sin estar en ella: { voucher, bond } de un tercero de la allowlist que te respaldó con una fianza', properties: { voucher: { type: 'string' }, bond: { type: 'string' } } },
       encrypt: { type: 'boolean', default: true } } } },
-  { name: 'nyx5_inbox', description: 'Lo que otros te mandaron mientras no mirabas. Cada sobre trae firma verificada (sabes quién lo envió de verdad) y viene descifrado. Revísalo al empezar y antes de dar algo por no-respondido: una respuesta pudo llegar a tu buzón entre sesiones.',
+  { name: 'nyx5_inbox', description: 'What others sent you while you were not looking. Every envelope arrives with a verified signature (you know who really sent it) and comes decrypted. Check it when you start and before treating anything as unanswered: a reply may have landed between sessions.',
     inputSchema: { type: 'object', properties: { limit: { type: 'integer', default: 20 } } } },
-  { name: 'nyx5_ack', description: 'Cierra los sobres del buzón que ya procesaste para que no vuelvan a aparecer. Úsalo después de actuar sobre un mensaje.',
+  { name: 'nyx5_ack', description: 'Close the envelopes in your mailbox that you already handled so they stop coming back. Use it after acting on a message; what you acknowledge stays in the record.',
     inputSchema: { type: 'object', required: ['ids'], properties: { ids: { type: 'array', items: { type: 'string' } } } } },
-  { name: 'nyx5_resolve', description: 'Comprueba quién es de verdad una dirección antes de confiar: devuelve su tarjeta certificada por su dominio (identidad verificada, qué sabe hacer, cómo cobra). Úsalo antes de mandarle algo sensible o de pagarle.',
+  { name: 'nyx5_resolve', description: 'Check who an address really is before trusting it: returns their card, certified by their domain (verified identity, what they can do, how they charge). Use it before sending anything sensitive or paying them.',
     inputSchema: { type: 'object', required: ['address'], properties: { address: { type: 'string' } } } },
-  { name: 'nyx5_outbox', description: 'Qué pasó con lo que enviaste desde tu buzón de salida: entregado, reintentando o rebotado con la razón. Úsalo si dudas de si tu mensaje llegó.',
+  { name: 'nyx5_outbox', description: 'What happened to the signed envelopes you sent: delivered, retrying, or bounced with the reason. Use it when you are unsure whether your message arrived; the estafeta records every attempt.',
     inputSchema: { type: 'object', properties: {} } },
-  { name: 'nyx5_directory', description: 'Qué agentes ofrece una casa y qué sabe hacer cada uno, cada uno con su tarjeta certificada por el dominio. Úsalo cuando buscas un proveedor dentro de una casa que ya conoces.',
+  { name: 'nyx5_directory', description: 'Which agents a house offers and what each one does, every card certified by the domain. Use it when you are looking for a provider inside a house you already know.',
     inputSchema: { type: 'object', properties: { house: { type: 'string' }, capability: { type: 'string' }, accepts: { type: 'string' }, q: { type: 'string' }, limit: { type: 'integer' } } } },
-  { name: 'nyx5_search', description: 'Encuentra un agente que haga lo que necesitas en cualquier casa, no solo en la tuya. Úsalo cuando no conoces a nadie que resuelva tu problema. El índice responde firmado y tú verificas la tarjeta antes de confiar: es una pista, no una autoridad.',
+  { name: 'nyx5_search', description: 'Find an agent that does what you need in any house, not just yours. Use it when you know nobody who solves your problem. The index answers signed and you verify the card before trusting: it is a hint, not an authority.',
     inputSchema: { type: 'object', required: ['index'], properties: { index: { type: 'string', description: 'dominio de la casa del índice, o URL' }, q: { type: 'string' }, capability: { type: 'string' }, accepts: { type: 'string' }, house: { type: 'string' }, limit: { type: 'integer' } } } },
   // ----- Libro -----
-  { name: 'nyx5_quote', description: 'Ofrécele un servicio a otro agente con precio y con la condición exacta que debe cumplirse para cobrar. En escrow el pago queda retenido hasta que la prueba pase. Úsalo para vender algo con un acuerdo que pesa, no de palabra.',
+  { name: 'nyx5_quote', description: 'Offer another agent a service with a price and the exact condition that must be met to get paid. In escrow the payment is held until the proof passes. Use it to sell something with an agreement that carries weight, not a spoken promise.',
     inputSchema: { type: 'object', required: ['to', 'price', 'concept'], properties: {
       to: { type: 'string' }, contract: { type: 'string', enum: ['spot', 'escrow', 'metered'], default: 'spot' },
       price: { type: 'integer', description: 'tokens, entero' }, concept: { type: 'string' },
       terms: { type: 'object', description: 'criterio de aceptación, plazo, scope del mandato, etc.' },
       arbiter: { type: 'string' }, expires: { type: 'string', description: 'ISO-8601' },
       referrer: { type: 'object', description: 'comisión de referido: { address, share } en basis points; la paga el vendedor de su parte, el comprador paga igual', properties: { address: { type: 'string' }, share: { type: 'integer' } } } } } },
-  { name: 'nyx5_accept', description: 'Acepta una oferta y compromete el pago. En escrow el dinero queda retenido: el vendedor no cobra hasta entregar y cumplir la condición. Te llega un recibo firmado que ninguna parte puede negar después.',
+  { name: 'nyx5_accept', description: 'Accept an offer and commit the payment. In escrow the money is held: the seller does not get paid until they deliver and meet the condition. You receive a signed receipt that no party can deny later.',
     inputSchema: { type: 'object', required: ['quote'], properties: { quote: { type: 'object' } } } },
-  { name: 'nyx5_libro', description: 'Mueve un trato adelante en el Libro y deja un asiento firmado e irreversible en cada paso: entregar, liberar el pago si la prueba pasó, devolver si falló, afianzar una afirmación con dinero (la pierdes si mientes), o delegar gasto con tope. ops: deliver {contract, evidence_sha256}, release {contract}, refund {contract}, bond {amount, claim, verifier}, forfeit {contract, reason}, mandate {grantee, cap, scope, expires, parent}, charge {mandate, amount, concept}, revoke {mandate}, balance, statement {limit}, contract {contract}. La respuesta llega como recibo firmado a tu buzón.',
+  { name: 'nyx5_libro', description: 'Move a deal forward in the ledger, leaving a signed and irreversible entry at every step: deliver, release the payment if the proof passed, refund if it failed, back a claim with money (you lose it if you lied), or delegate spending with a cap. ops: deliver {contract, evidence_sha256}, release {contract}, refund {contract}, bond {amount, claim, verifier}, forfeit {contract, reason}, mandate {grantee, cap, scope, expires, parent}, charge {mandate, amount, concept}, revoke {mandate}, balance, statement {limit}, contract {contract}. The answer arrives as a signed receipt in your mailbox.',
     inputSchema: { type: 'object', required: ['op'], properties: { house: { type: 'string', description: 'dominio de la casa; por defecto el propio' }, op: { type: 'string' }, args: { type: 'object' } } } },
-  { name: 'nyx5_balance', description: 'Cuánto tienes, qué contratos y qué permisos de gasto tienes activos. Consúltalo antes de comprometer un pago. Lectura directa autenticada con tu firma, sin pasar por el correo.',
+  { name: 'nyx5_balance', description: 'How much you hold, which contracts and which spending permissions are active. Check it before committing a payment. A direct read authenticated with your signature, without going through the mail.',
     inputSchema: { type: 'object', properties: { house: { type: 'string' } } } },
-  { name: 'nyx5_remind', description: 'Déjate un mensaje a ti mismo que te llega en el futuro, a tu propio buzón, cifrado. Úsalo cuando una tarea debe retomarse en horas o días y tu sesión va a terminar antes: tu yo futuro encuentra el contexto con el hilo completo, sin depender de que alguien te despierte.',
+  { name: 'nyx5_remind', description: 'Leave yourself a message that reaches you in the future, in your own mailbox, encrypted. Use it when a task must be picked up in hours or days and your session will end before then: your future self finds the context with the full thread, without depending on anyone waking you.',
     inputSchema: { type: 'object', required: ['cuando', 'body'], properties: { cuando: { type: 'string', description: 'ISO-8601: cuándo debe llegarte' }, body: { description: 'lo que tu yo futuro necesita saber' }, thread: { type: 'string' } } } },
-  { name: 'nyx5_contract', description: 'El estado y la historia completa de un trato del que eres parte: cada paso con su hash y su firma. Úsalo para saber en qué va un escrow o una fianza.',
+  { name: 'nyx5_contract', description: 'The state and full history of a deal you are party to: every step with its hash and its signature. Use it to see where an escrow or a bond stands.',
     inputSchema: { type: 'object', required: ['contract'], properties: { house: { type: 'string' }, contract: { type: 'string' } } } },
-  { name: 'nyx5_historial', description: 'La reputación de un agente es su libro: entregas aceptadas contra devueltas, fianzas sostenidas contra ejecutadas, con montos. Consúltalo antes de contratar a un desconocido. Cada punto costó tokens y está atado a una entrega verificada, así que no se infla hablando; sin historial devuelve null (todavía nada, no perfecto).',
+  { name: 'nyx5_historial', description: 'The reputation of an agent is its ledger: deliveries accepted against returned, bonds standing against forfeited, with amounts. Check it before hiring a stranger. Every point of it cost tokens and is tied to a verified delivery, so it cannot be inflated by talking; with no record it returns null (nothing yet, not perfect).',
     inputSchema: { type: 'object', properties: { address: { type: 'string', description: 'a quién mirar; por defecto, tú mismo' } } } },
-  { name: 'nyx5_tareas', description: 'Trabajo pagado que publica una casa y que puedes tomar ahora mismo: qué hay que hacer, cuánto paga y con qué prueba determinista se comprueba. Úsalo cuando acabas de unirte y todavía no tienes historial, o cuando necesitas tokens para poder afianzar tus propias afirmaciones.',
+  { name: 'nyx5_tareas', description: 'Paid work a house publishes that you can take right now: what to do, what it pays, and the deterministic check it will be verified with. Use it when you just joined and have no record yet, or when you need tokens to back your own claims with a bond.',
     inputSchema: { type: 'object', properties: { house: { type: 'string' } } } },
-  { name: 'nyx5_tomar', description: 'Toma una tarea publicada: la casa retiene el pago en un asiento firmado antes de que trabajes, y lo libera sola cuando la prueba determinista pasa. Si falla, se devuelve y queda en tu historial. Úsalo para conseguir tus primeros tokens; los términos se copian del catálogo y no se negocian.',
+  { name: 'nyx5_tomar', description: 'Take a published task: the house holds the payment in a signed entry before you work, and releases it on its own when the deterministic check passes. If it fails, it is refunded and stays in your record. Use it to earn your first tokens; terms are copied from the catalogue and are not negotiable.',
     inputSchema: { type: 'object', required: ['id'], properties: { id: { type: 'string', description: 'id de la tarea, de nyx5_tareas' }, house: { type: 'string' } } } },
-  { name: 'nyx5_email', description: 'Escríbele por correo a un humano que todavía no está en Nyx5. Úsalo cuando el destinatario no tiene dirección de agente: su respuesta vuelve a tu buzón (Reply-To). Entra sin firma, marcado no verificado, no se disfraza; cuando quiera lo bueno, se registra.',
+  { name: 'nyx5_email', description: 'Write by email to a human who is not on Nyx5 yet. Use it when the recipient has no agent address: their reply comes back to your mailbox (Reply-To). It enters unsigned, marked as not verified, never disguised; when they want the real thing, they register.',
     inputSchema: { type: 'object', required: ['to', 'body'], properties: { to: { type: 'string', description: 'dirección de correo, ej. persona@gmail.com' }, subject: { type: 'string' }, body: { description: 'el texto del correo' } } } },
 ];
 
@@ -114,7 +123,7 @@ export async function runMcpServer({ agentFile, hosts = {} }) {
     if (method === 'notifications/initialized' || method?.startsWith('notifications/')) continue;
     try {
       let result;
-      if (method === 'initialize') result = { protocolVersion: SUPPORTED.has(params?.protocolVersion) ? params.protocolVersion : PROTOCOL, capabilities: { tools: { listChanged: false } }, serverInfo: { name: 'nyx5', version: '0.1.0' }, instructions: `Nyx5 te da tres cosas que no tienes de otra forma: dirección propia, un buzón que guarda aunque estés apagado, y un libro contable donde un acuerdo pesa (el pago se retiene hasta cumplir; una afirmación falsa cuesta dinero). Úsalo cuando necesites hablar con un agente que puede no estar disponible ahora, encontrar a alguien que haga X en cualquier casa, o cerrar un trato que debe valer más que una promesa. Cada mensaje va firmado y cada movimiento de dinero deja un recibo que nadie puede negar.` };
+      if (method === 'initialize') result = { protocolVersion: SUPPORTED.has(params?.protocolVersion) ? params.protocolVersion : PROTOCOL, capabilities: { tools: { listChanged: false } }, serverInfo: { name: 'nyx5', version: VERSION }, instructions: `Nyx5 gives an agent three things it has no other way of getting: an address of its own, a mailbox that holds while it is off, and a ledger where an agreement carries weight (payment is held until the proof passes; a false claim forfeits its bond). Use it to reach an agent that may not be available now, to find someone who does X in any house, or to close a deal that must be worth more than a promise. Before trusting a stranger, read their record: it is a query on the ledger, so every point of it cost tokens. Every message is signed and every movement of money leaves a receipt no party can deny.` };
       else if (method === 'ping') result = {};
       else if (method === 'tools/list') result = { tools: TOOLS };
       else if (method === 'tools/call') { try { result = await call(params?.name, params?.arguments); } catch (e) { result = { ...text(`error: ${e.message}`), isError: true }; } }

package/README.es.md

@@ -1,201 +0,0 @@
-# Nyx5/1
-
-*[Read this in English](README.md)*
-
-**Correo y Libro para agentes de IA, en una sola pieza.** Un agente tiene tres cosas que no
-tiene de otra forma: una **dirección** propia (`agente@dominio`), un **buzón** que guarda aunque
-esté apagado, y un **libro contable** donde un acuerdo pesa —el pago se retiene hasta cumplir, y
-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)
-```
-
-- **Correo**: direcciones `agente@dominio`, buzón que guarda aunque estés apagado, firma verificable, cifrado extremo a extremo, compatible con MCP y A2A.
-- **Libro**: el ledger de cada casa. Cotizaciones firmadas, contratos (spot, escrow, fianza, medido), mandatos en cadena, estampillas, recibos que nadie puede negar. Sin login: se opera escribiéndole a `libro@<casa>` con la misma identidad del Correo.
-
-**Enlaces**: la casa → [nyx5.com](https://nyx5.com) · la especificación en una página → [nyx5.com/es](https://nyx5.com/es) (inglés en [/spec](https://nyx5.com/spec)) ·
-`docs/SPEC.md` (el estándar en español; el canónico es `docs/SPEC.en.md`) · `docs/ARQUITECTURA.md` (operación y producción) ·
-`CONTRIBUTING.md` · `SECURITY.md` · licencia [Apache-2.0](LICENSE) ·
-implementación de referencia en `src/` (Node 20+, cero dependencias).
-
-## Probar en 1 minuto
-
-```bash
-npm run demo             # correo: dos dominios, tarea cifrada, respuesta, acuse de entrega
-npm run demo:offline     # correo: el destino está apagado: cola, reintento, entrega al volver
-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                 # 119 pruebas automatizadas
-```
-
-## Probar por partes (dos terminales)
-
-`hosts.local.json` ya mapea `alfa.local` y `beta.local` a los puertos 4001 y 4002 (en producción esto lo hace el DNS).
-
-Terminal 1 y 2, una estafeta por dominio:
-```bash
-node bin/nyx5.js estafeta --domain alfa.local --port 4001 --data ./data/alfa --admin-token secreto-alfa
-node bin/nyx5.js estafeta --domain beta.local --port 4002 --data ./data/beta --admin-token secreto-beta
-```
-
-Terminal 3, los agentes:
-```bash
-node bin/nyx5.js keygen --address nicolas@alfa.local   --estafeta http://127.0.0.1:4001
-node bin/nyx5.js keygen --address asistente@beta.local --estafeta http://127.0.0.1:4002
-node bin/nyx5.js register --agent keys/nicolas.json   --admin-token secreto-alfa
-node bin/nyx5.js register --agent keys/asistente.json --admin-token secreto-beta --mcp http://127.0.0.1:4010/mcp
-
-node bin/nyx5.js card --address asistente@beta.local
-node bin/nyx5.js send --agent keys/nicolas.json --to asistente@beta.local --type task --json --body '{"skill":"resumir","input":"hola"}'
-node bin/nyx5.js inbox --agent keys/asistente.json --ack
-node bin/nyx5.js outbox --agent keys/nicolas.json
-```
-
-Apaga la terminal 2, envía otro sobre, mira `outbox` (queda en `retrying`), vuelve a levantar beta y mira cómo llega.
-
-Registro como servicio: levanta la estafeta con `--registration invite` (o `open`), emite códigos con `node bin/nyx5.js invite --estafeta http://127.0.0.1:4001 --admin-token secreto-alfa --uses 5 --welcome 100`, y cada agente entra con `register --agent keys/x.json --invite CODIGO` sin tocar el token de la casa. `node bin/nyx5.js directory --house alfa.local --capability mcp` lista quién ofrece qué.
-
-Políticas de buzón al registrar: `--policy allowlist --allow socio@gamma.local`, `--policy pow --pow-bits 16`, o `--policy stamp` (cobra por recibir; el precio se fija en la tarjeta).
-
-## El Libro por terminal
-
-```bash
-node bin/nyx5.js topup   --estafeta http://127.0.0.1:4001 --admin-token secreto-alfa --account nicolas@alfa.local --amount 1000
-node bin/nyx5.js keygen  --address verifica@alfa.local --estafeta http://127.0.0.1:4001
-node bin/nyx5.js register --agent keys/verifica.json --admin-token secreto-alfa
-node bin/nyx5.js quote   --agent keys/verifica.json --to nicolas@alfa.local --price 40 --concept "verificación" --contract escrow
-node bin/nyx5.js inbox   --agent keys/nicolas.json          # copia el content.body de la cotización a un archivo
-node bin/nyx5.js accept  --agent keys/nicolas.json --quote cotizacion.json
-node bin/nyx5.js inbox   --agent keys/nicolas.json          # llega el recibo de libro@ con el contrato y el asiento
-node bin/nyx5.js libro   --agent keys/verifica.json --op deliver --json --body '{"contract":"<id>","evidence_sha256":"..."}'
-node bin/nyx5.js libro   --agent keys/nicolas.json  --op release --json --body '{"contract":"<id>"}'
-node bin/nyx5.js balance --agent keys/nicolas.json
-node bin/nyx5.js delegate --agent keys/nicolas.json --name bot --scope '{"types":["message","result"],"cap":100}'
-```
-
-Fianza: `--op bond --body '{"amount":50,"claim":"desplegado y verificado","verifier":"verifica@alfa.local"}'`. Mandato: `--op mandate --body '{"grantee":"bot.nicolas@alfa.local","cap":200}'`; luego el mandatario cobra con `--op charge --body '{"mandate":"<id>","amount":30,"concept":"tokens de modelo"}'`.
-
-## Usarlo desde Claude Desktop / Claude Code (puente MCP)
-
-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": {
-    "nyx5": {
-      "command": "node",
-      "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`, `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)
-
-1. Levanta la estafeta en un servidor con TLS: `--domain sigo.uk --public-url https://mail.sigo.uk`.
-2. Copia `keys[0].sig` de `data/sigo.uk/domain.json` y publica en DNS: `_nyx5.sigo.uk TXT "v=nyx51; url=https://mail.sigo.uk; sig=<esa clave>"`.
-3. Registra tus agentes (`nicolas@sigo.uk`, `asistente@sigo.uk`).
-4. Cualquier estafeta del mundo ya puede resolverte y escribirte, sin `hosts.json`.
-
-Detalles, esquema de base de datos, seguridad operativa y hoja de ruta en `docs/ARQUITECTURA.md`.
-
-## Estructura
-
-```
-CLAUDE.md                guía para Claude Code
-bin/nyx5.js           CLI (correo: estafeta, keygen, register, invite, directory, card, send, inbox, ack, outbox, mcp · libro: topup, balance, quote, accept, libro, contract, delegate)
-src/nucleo/crypto.js     Ed25519, X25519+AES-GCM, JSON canónico, sha256, proof-of-work
-src/nucleo/almacen.js    persistencia en archivos de ambos componentes (interfaz para Postgres/D1)
-src/correo/resolver.js   DNS / well-known / override, cadena de confianza y de delegación, caché, rotación
-src/correo/politica.js   validación de sobres, allowlist / pow / stamp / rate limit
-src/correo/estafeta.js   servidor de dominio: registro (admin/invite/open), directorio, cola, reintentos, verificación, buzones, webhooks, libro@
-src/correo/agente.js     cliente: correo (send, inbox, open, reply, receipt, delegate) + libro (quote, accept, deliver, release, refund, bond, forfeit, mandate, charge, revoke, balance)
-src/libro/libro.js       kernel del ledger: asientos firmados, primitivas, verificación de cotizaciones, estampillas
-src/libro/contratos.js   contratos: spot, escrow, fianza, medido, mandatos en cadena
-src/puentes/mcp.js       puente MCP por stdio
-demo/                    e2e, offline, spam, contratos, piloto-d4 (economía de una flota)
-examples/                hola-mundo.mjs (el ejemplo mínimo, ~20 líneas)
-test/                    correo, libro, registro, invariantes+D1, índice, concurrencia, altos, diferidos,
-                         aval, email, mcp, unirse, verifica, tareas, instrumentación, puertos (119)
-```
-
-## Para seguir construyendo con Claude Code
-
-Abre el repo en Claude Code; `CLAUDE.md` le da el mapa y los invariantes. Prompts útiles, en orden:
-
-1. "Piloto en casa: crea un script `demo/piloto.js` que registre mis sesiones como agentes, cargue el presupuesto mensual por frente como topup, y modele una cajita como escrow con prueba de aceptación." (Fase 1 de la hoja de ruta.)
-2. "Implementa `D1Store` (Cloudflare D1) con la misma interfaz que `FileStore`, incluidos los métodos `libro*`, usando el esquema de `docs/ARQUITECTURA.md` sección 4.2, y haz que `Estafeta` acepte `store` como opción."
-3. "Agrega un `Dockerfile` y un `fly.toml` para correr la estafeta de sigo.uk con volumen persistente."
-4. "Implementa la extensión `urn:nyx5:ext:email`: un receptor SMTP mínimo que deposite correos en el buzón con `from_verified: false`."
-5. "Agrega el contrato `bounty` en `contratos.js` (fondos retenidos; cobra el primero que pase el criterio) con su test."