Saltar al contenido principal
El SDK oficial @nekzus/neural-mesh proporciona un conjunto de herramientas completo y fuertemente tipado para construir Clientes NMP (Agent Nodes) y Servidores NMP (Data Nodes) en TypeScript y JavaScript. Si estás migrando desde el Model Context Protocol (MCP), la API te resultará muy familiar. NMP fue diseñado para ofrecer una experiencia de desarrollo de reemplazo directo (drop-in replacement), abstrayendo la complejidad de Protobuf, WebAssembly y Kademlia DHT bajo clases de TypeScript sencillas.

Arquitectura del Paquete

El SDK se publica en npm como un único paquete que contiene tanto la lógica del Cliente como la del Servidor:
npm install @nekzus/neural-mesh zod
Recomendamos instalar zod junto al SDK. Al igual que en la especificación MCP, NMP utiliza Zod para garantizar que los argumentos de ejecución coincidan con el manifiesto de capacidades del servidor.

Funcionamiento Interno: El Compilador Javy

Si NMP inyecta lógica compilada en WebAssembly (.wasm), ¿cómo es posible desarrollar Agentes puramente en TypeScript? El SDK incluye un puente de compilación nativo. Cuando un Agente TypeScript invoca .execute(), el SDK serializa el payload de JavaScript, lo empaqueta usando un motor similar a Javy en un módulo .wasm restrictivo y lo inyecta en la malla a través de gRPC. El desarrollador nunca tiene que escribir ni compilar Rust/Wasm manualmente.

Características Enterprise de Vanguardia

El SDK TypeScript mantiene paridad arquitectónica con el núcleo en Rust, asegurando restricciones Zero-Trust de grado empresarial:
  • Criptografía Post-Cuántica (ML-KEM-768): Encapsulación asimétrica (crystals-kyber) y autenticación simétrica AES-256-GCM de extremo a extremo.
  • Transporte Híbrido: Conectividad P2P en Node.js y navegadores mediante WebSockets (WS/Mplex) y TCP (Yamux).
  • Guardian-TS (Inspección AST): Mitigación proactiva de escapes del sandbox mediante el análisis del binario antes de su ejecución.
  • ZK-Receipt Ready: Soporte nativo para Pruebas Cero Conocimiento matemáticas contra zkVMs.
  • Escalado Multi-Core (Worker Pool): Alto rendimiento mediante piscina, delegando el descifrado y la ejecución de sandboxes a hilos del SO independientes del Event Loop de V8.

Exportaciones Principales

El SDK exporta tres clases principales:

NmpServer

El receptor de datos. Expone capacidades locales y archivos, y maneja la intención de Logic-on-Origin de forma segura.

NmpClient

El nodo de inteligencia. Busca capacidades en la malla e inyecta payloads WASM para procesar datos.

NmpMcpBridge

El Traductor de Legado. Puentea instantáneamente tools y resources entre clientes MCP JSON-RPC heredados y tu red NMP de alto rendimiento.

Deep Dive: Pool Transaccional Multi-Core

NMP rompe la limitación de hilo único de Node.js mediante el enrutamiento de la carga criptográfica a hilos aislados del SO.

Comenzando