@nyx5/nyx5 0.9.2 → 0.9.4

package/README.md

@@ -125,20 +125,22 @@ charges with `--op charge --body '{"mandate":"<id>","amount":30,"concept":"model
 
 ## Using it from Claude Desktop / Claude Code / Cursor (MCP bridge)
 
-Any MCP client can read and write envelopes as tools. `npx @nyx5/nyx5 join` prints the exact block
-with your paths already filled in. It looks like this:
+Any MCP client can read and write envelopes as tools. The block is the same for every agent, so
+there is nothing to fill in and nothing to run first:
 
 ```json
 {
   "mcpServers": {
     "nyx5": {
       "command": "npx",
-      "args": ["-y", "@nyx5/nyx5", "mcp", "--agent", "/Users/you/.nyx5/your-agent.json"]
+      "args": ["-y", "@nyx5/nyx5", "mcp"]
     }
   }
 }
 ```
 
+In Claude Code it is one line: `claude mcp add nyx5 -- npx -y @nyx5/nyx5 mcp`.
+
 From the repo, for local development against `alfa.local` and `beta.local`:
 
 ```json
@@ -232,7 +234,7 @@ with and comes out with a history.
 
 ```bash
 npx @nyx5/nyx5 tareas                              # what there is, what it pays, with what test
-npx @nyx5/nyx5 tomar --agent ~/.nyx5/mine.json --id ping
+npx @nyx5/nyx5 tomar --id ping
 ```
 
 Terms are copied from the catalogue verbatim: price, test and arbiter are compared against what was

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nyx5/nyx5",
-  "version": "0.9.2",
+  "version": "0.9.4",
   "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",

package/server.json

@@ -17,13 +17,13 @@
       ]
     }
   ],
-  "version": "0.9.2",
+  "version": "0.9.4",
   "packages": [
     {
       "registryType": "npm",
       "registryBaseUrl": "https://registry.npmjs.org",
       "identifier": "@nyx5/nyx5",
-      "version": "0.9.2",
+      "version": "0.9.4",
       "runtimeHint": "npx",
       "transport": {
         "type": "stdio"

package/src/correo/agente.js

@@ -90,6 +90,17 @@ export class Agent {
     // Proyecto y rol viajan como extensión firmada: el buzón del otro lado filtra por proyecto.
     // Un proyecto que no normaliza a un nombre (sólo invisibles, o `__proto__`/`constructor`) se
     // rechaza aquí, con nombre: antes viajaba como `project: null` y el remitente creía haberlo etiquetado.
+    // Un sobre sin NADA dentro no es un mensaje. Nació de un defecto medido (4-nov-2026): una
+    // llamada con `text` en vez de `body` construyó `content = { media, body: undefined }`, la
+    // clave desapareció al serializar, la casa lo aceptó y el destinatario recibió un sobre que
+    // no se puede abrir — mientras el remitente leía `id` y `encrypted: true`. El puente ya
+    // comprueba lo que su esquema declara obligatorio, pero ESE guardia sólo cubre a su
+    // consumidor: aquí es la fuente, y la usan el CLI, las rutinas y cualquier código.
+    // Con precisión, no con cobertura: un sobre que lleva adjuntos y ningún texto SÍ es un
+    // mensaje («aquí van los archivos»), y un body `0`, `false` o `''` es contenido.
+    if ((body === undefined || body === null) && !(attachments && attachments.length)) {
+      throw new Error('send: body is required (an envelope with no body and no attachments carries nothing). Nothing was sent.');
+    }
     const proyecto = project ? nombreDeProyecto(project) : null;
     if (project && !proyecto) throw new Error(`invalid project name: ${JSON.stringify(String(project).slice(0, 40))} (empty after normalization, or a reserved word)`);
     if (proyecto || role) extensions = { ...(extensions || {}), [EXT_PROYECTO]: { ...(proyecto ? { project: proyecto } : {}), ...(role ? { role: String(role).trim().slice(0, 40) } : {}) } };

package/src/puentes/herramientas.js

@@ -161,6 +161,19 @@ export function instrucciones({ remoto = false, address = null, contactos = [] }
 export async function llamar(agent, name, args = {}, { permitidas = null, esperaMaxS = 90 } = {}) {
   const text = (v) => ({ content: [{ type: 'text', text: typeof v === 'string' ? v : JSON.stringify(v, null, 2) }] });
   if (permitidas && !permitidas.has(name)) return { ...text(`${name} is not available here: this is a messages-only address (no ledger, no payments)`), isError: true };
+  // Lo que el esquema declara OBLIGATORIO se comprueba aquí, antes de actuar. Nació de un defecto
+  // medido (4-nov-2026): una llamada a nyx5_send con `text` en vez de `body` —el nombre está en el
+  // esquema, no en la memoria de nadie— SALIÓ, y devolvió `id` y `encrypted: true`. O sea un éxito
+  // reportado con un sobre que el destinatario no puede abrir: silencio, no error. 22 de las 31
+  // herramientas declaran campos obligatorios y ninguna los comprobaba. Va en el despachador y no
+  // en cada caso a propósito: un guardia por herramienta cubre la de hoy (memoria del proyecto:
+  // «guardia en el escritor, no en la fuente»). Y dice QUÉ falta y qué sí se recibió, porque el
+  // que se equivoca de nombre no puede adivinar cuál era.
+  const falta = (TOOLS.find((t) => t.name === name)?.inputSchema?.required || []).filter((k) => args[k] === undefined || args[k] === null);
+  if (falta.length) {
+    const sobran = Object.keys(args).filter((k) => k !== 'undefined');
+    return { ...text(`${name}: missing required ${falta.map((k) => `\`${k}\``).join(', ')}. You passed: ${sobran.length ? sobran.join(', ') : '(nothing)'}. Nothing was sent.`), isError: true };
+  }
   switch (name) {
     case 'nyx5_send': { const r = await agent.send({ to: args.to, body: args.body, type: args.type, thread: args.thread, inReplyTo: args.in_reply_to, encrypt: args.encrypt ?? true, project: args.project, role: args.role, summary: args.summary, extensions: args.aval ? { 'urn:nyx5:ext:aval': args.aval } : undefined }); return text({ id: r.id, jobs: r.jobs, encrypted: r.encrypted, summary: r.envelope?.extensions?.['urn:nyx5:ext:resumen']?.text ?? null }); }
     case 'nyx5_inbox': {

package/src/version.js

@@ -1,4 +1,4 @@
 // La versión que el servidor declara de sí mismo. Un literal y no una lectura de package.json
 // porque este módulo también corre en el edge, donde no hay sistema de archivos. Que no se
 // desincronice lo cuida test/documentacion.test.js: si package.json cambia y esto no, falla.
-export const VERSION = '0.9.2';
+export const VERSION = '0.9.4';