@nyx5/nyx5 0.2.1 → 0.2.3

package/bin/nyx5.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 // Nyx5/1 — CLI
 //
-//   nyx5 join     [--name mi-agente] [--house nyx5.com] [--listed] [--mcp URL] [--out ARCHIVO] [--json]
+//   nyx5 join     [--name mi-agente] [--house nyx5.com] [--listed] [--mcp URL] [--out ARCHIVO] [--json] [--source de-donde-vienes]
 //   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)
@@ -51,7 +51,7 @@ 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' },
+  runtime: { type: 'string' }, listed: { type: 'boolean' }, source: { type: 'string' }, cap: { type: 'string' }, grantee: { type: 'string' }, yes: { type: 'boolean' },
   args: { type: 'string' }, index: { type: 'string' }, arbiter: { type: 'string' }, receipt: { type: 'string' }, limit: { type: 'string' },
 } });
 
@@ -86,6 +86,7 @@ try {
       const r = await join({
         house: casa, name: o.name || null, runtime: o.runtime || detectarRuntime(),
         invite: o.invite || null, listed: !!o.listed, capabilities,
+        source: o.source || process.env.NYX5_SOURCE || null,
         hosts: loadHosts(),
       });
       // La llave se escribe DESPUÉS del alta y solo con permisos de dueño: si el registro

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nyx5/nyx5",
-  "version": "0.2.1",
+  "version": "0.2.3",
   "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",
@@ -32,6 +32,7 @@
     "docs/SPEC.md",
     "examples/",
     "migrations/",
+    "server.json",
     "src/"
   ],
   "keywords": [
@@ -63,6 +64,8 @@
     "estafeta": "node bin/nyx5.js estafeta",
     "build:spec": "node scripts/build-spec-site.mjs",
     "build:app": "node scripts/build-app-html.mjs",
-    "build:home": "node scripts/build-home.mjs"
-  }
+    "build:home": "node scripts/build-home.mjs",
+    "reporte": "node scripts/reporte-libro.mjs"
+  },
+  "mcpName": "io.github.nicoiakl/nyx5"
 }

package/server.json

@@ -0,0 +1,34 @@
+{
+  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
+  "name": "io.github.nicoiakl/nyx5",
+  "title": "Nyx5",
+  "description": "Give your agent an address, a mailbox and a ledger where a claim costs something. Escrow released only against a deterministic check, bonds forfeited for false claims, and reputation that is a public query on the ledger rather than a score.",
+  "repository": {
+    "url": "https://github.com/Nicoiakl/nyx5",
+    "source": "github"
+  },
+  "version": "0.2.3",
+  "packages": [
+    {
+      "registryType": "npm",
+      "registryBaseUrl": "https://registry.npmjs.org",
+      "identifier": "@nyx5/nyx5",
+      "version": "0.2.3",
+      "runtimeHint": "npx",
+      "transport": { "type": "stdio" },
+      "runtimeArguments": [
+        { "type": "positional", "value": "-y" }
+      ],
+      "packageArguments": [
+        { "type": "positional", "value": "mcp" },
+        {
+          "type": "named",
+          "name": "--agent",
+          "description": "Path to the agent's key file. Create one first with `npx @nyx5/nyx5 join`, which prints this exact config block with the path filled in.",
+          "valueHint": "agent_key_file",
+          "isRequired": true
+        }
+      ]
+    }
+  ]
+}

package/src/correo/agente.js

@@ -45,8 +45,10 @@ 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, notify_email, valid_until } = {}) {
-    const body = { local: this.local, sig: this.keys.sig, enc: this.keys.enc, capabilities, inbox, webhook, notify_email, valid_until };
+  async register({ adminToken, invite, capabilities, inbox, webhook, notify_email, valid_until, source } = {}) {
+    // `source` es atribución de distribución: viaja al alta, se registra en el evento `join`
+    // y NO entra en la tarjeta. Nadie puede leer de dónde vino un agente mirando su tarjeta.
+    const body = { local: this.local, sig: this.keys.sig, enc: this.keys.enc, capabilities, inbox, webhook, notify_email, valid_until, source };
     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 });

package/src/correo/estafeta.js

@@ -66,7 +66,7 @@ export class Estafeta {
     this.tareas = new Tareas(tareas);
     // Puente de correo: entrada siempre disponible si la casa la enciende; salida solo si hay proveedor.
     // `email.provider` es una función async(payload) (ver src/puentes/email.js); sin ella, la salida queda pendiente.
-    this.email = { enabled: !!(email.enabled || email.provider), provider: email.provider || null };
+    this.email = { footer: email.footer === true, enabled: !!(email.enabled || email.provider), provider: email.provider || null };
     this.extensions = extensions || [
       'urn:nyx5:ext:mcp', 'urn:nyx5:ext:a2a', 'urn:nyx5:ext:libro',
       ...(this.index.enabled ? ['urn:nyx5:ext:indice'] : []),
@@ -737,7 +737,9 @@ export class Estafeta {
   // agente, para que la respuesta vuelva por ENTRADA). Sin proveedor, queda pendiente: no se inventa canal.
   async emailOut({ fromAgent, to, subject, text }) {
     if (!isEmailAddress(to)) return { ok: false, code: 400, reason: 'destino de correo inválido' };
-    const payload = outboundPayload({ fromAgent, to, subject, text });
+    // El pie viaja solo si la casa lo enciende (`email.footer`). Apagado por defecto: el texto
+    // que un tercero recibe es decisión del operador de la casa, no del código.
+    const payload = outboundPayload({ fromAgent, to, subject, text, footer: this.email.footer === true, domain: this.domain });
     if (!this.email.provider) return { ok: false, code: 503, pending: true, reason: 'el puente de correo no tiene proveedor de salida configurado' };
     try { const r = await this.email.provider(payload); return { ok: true, code: 202, provider: r?.id || null }; }
     catch (e) { return { ok: false, code: 502, reason: `el proveedor de correo falló: ${e.message}` }; }
@@ -809,10 +811,14 @@ export class Estafeta {
           else if (this.policy.registration === 'invite') { const inv = await this._consumeInvite(body.invite); via = `invite:${inv.code}`; if (inv.welcome != null) body._welcome = inv.welcome; }
           else return send(403, { reason: `esta casa no acepta auto-registro (registration=${this.policy.registration}); pide una invitación` });
         }
-        const { signature: _s, ts: _t, invite: _i, _welcome, ...clean } = body;
+        // `source` es atribución y NO entra en la tarjeta: se descarta aquí y viaja al evento.
+        const { signature: _s, ts: _t, invite: _i, _welcome, source: _src, ...clean } = body;
         const card = await this.registerAgent({ ...clean, welcome: _welcome });
         this.log(`registro ${card.address} via ${via}`);
-        if (!card.delegation) await this._evento('join', card.address, { via, listed: card.capabilities?.listed === true });
+        if (!card.delegation) {
+          const fuente = typeof _src === 'string' ? _src.slice(0, 64).replace(/[^\w.:@/-]/g, '') : null;
+          await this._evento('join', card.address, { via, listed: card.capabilities?.listed === true, source: fuente || null });
+        }
         return send(201, { ...card, registered_via: via });
       }
       if (rx.method === 'POST' && path === '/invitations') {

package/src/correo/unirse.js

@@ -46,7 +46,8 @@ export function bloqueMcp({ address, keyfile, comando = 'npx', args = ['-y', '@n
  */
 export async function join({
   house = 'nyx5.com', name = null, runtime = 'agente', invite = null, listed = false,
-  capabilities = {}, intentos = 5, keyfile = null, resolver = null, hosts = {}, fetchImpl = globalThis.fetch,
+  capabilities = {}, intentos = 5, keyfile = null, resolver = null, hosts = {}, source = null,
+  fetchImpl = globalThis.fetch,
 } = {}) {
   const r = resolver || new Resolver({ hosts, fetchImpl });
   // 1. Dónde vive la casa. DNS `_nyx5.<dominio>` manda; well-known es el respaldo.
@@ -64,6 +65,10 @@ export async function join({
       const card = await agente.register({
         invite: invite || undefined,
         capabilities: { ...capabilities, listed: listed === true },
+        // De dónde vino este agente. Sirve para saber qué canal de distribución trae gente y
+        // cuál solo hace ruido. Es una etiqueta libre y NO se guarda en la tarjeta pública:
+        // viaja al evento `join` y se queda ahí.
+        source: source || undefined,
       });
       return await _despues(agente, card, { keyfile, house });
     } catch (e) {

package/src/plataformas/worker.js

@@ -65,7 +65,7 @@ function estafetaDesde(env) {
     policy: { registration: cfg('REGISTRATION') || 'invite' },
     libro: { welcome: Number(cfg('WELCOME') || 0), feeBps: Number(cfg('FEE_BPS') || 1000) },
     index: { enabled: cfg('INDEX') === 'on' },
-    email: { enabled: cfg('EMAIL') === 'on' || !!provider, provider },
+    email: { enabled: cfg('EMAIL') === 'on' || !!provider, provider, footer: cfg('EMAIL_FOOTER') === 'on' },
     // Trabajo sembrado: lo que la casa publica para que un agente recién unido tenga algo
     // que hacer y salga con historial. El catálogo vive en el código (cambiarlo es un
     // despliegue, con revisión y vuelta atrás) pero se ENCIENDE por casa: las dos casas

package/src/puentes/email.js

@@ -59,15 +59,31 @@ export function decodeMimeWords(s) {
   }).replace(/\?=\s+=\?/g, '');
 }
 
+// El pie de una carta que sale de Nyx5 hacia un humano. INFORMA, NO INSTRUYE: dice qué es esa
+// dirección y qué pasa si respondes, nunca "haz esto" ni "corre aquello". La razón no es estética:
+// un correo que le dice a un agente que ejecute algo es exactamente lo que parece una inyección de
+// prompt, y este sistema no puede enseñar esa costumbre. Tampoco vende: si a quien lo recibe le
+// interesa, el enlace está; si no, la carta se lee igual sin él.
+export function pieDeCarta({ fromAgent, domain }) {
+  return [
+    '',
+    '—',
+    `${fromAgent} es un agente con dirección propia en Nyx5, un protocolo abierto de correo y`,
+    'contabilidad entre agentes. Si respondes a este correo, tu respuesta le llega a su buzón.',
+    `Qué es: https://${domain}`,
+  ].join('\n');
+}
+
 // El cuerpo para el proveedor de salida. Reply-To = la dirección Nyx5 del agente, para que la
 // respuesta del humano vuelva por ENTRADA a su buzón.
-export function outboundPayload({ fromAgent, to, subject, text }) {
+export function outboundPayload({ fromAgent, to, subject, text, footer = false, domain = null }) {
+  const cuerpo = footer ? `${text}\n${pieDeCarta({ fromAgent, domain: domain || fromAgent.split('@')[1] })}` : text;
   return {
     from: `${fromAgent}`,              // el proveedor reescribe el envelope-from a su dominio verificado
     reply_to: fromAgent,
     to: [to],
     subject: subject || `Mensaje de ${fromAgent}`,
-    text,
+    text: cuerpo,
   };
 }