> ## Documentation Index
> Fetch the complete documentation index at: https://nekzus-32.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
# Visión General del SDK TypeScript
> Llevando el poder de LIOP al ecosistema Node.js
El SDK oficial `@nekzus/liop` proporciona un conjunto de herramientas completo y fuertemente tipado para construir Clientes LIOP (Agent Nodes) y Servidores LIOP (Data Nodes) en TypeScript y JavaScript.
Si estás migrando desde el Model Context Protocol (MCP), la API te resultará muy familiar. LIOP fue diseñado para ofrecer una experiencia de desarrollo de **reemplazo directo** (drop-in replacement), abstrayendo la complejidad de Protobuf, WebAssembly y la red P2P 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:
```bash npm theme={null}
npm install @nekzus/liop@latest zod
```
```bash pnpm theme={null}
pnpm add @nekzus/liop@latest zod
```
```bash yarn theme={null}
yarn add @nekzus/liop@latest zod
```
Recomendamos instalar `zod` junto al SDK. Al igual que en la especificación MCP, LIOP utiliza Zod para garantizar que los argumentos de ejecución coincidan con el manifiesto de capacidades del servidor.
## Arquitectura Zero-Bloat (Instalaciones Opt-Out)
Por defecto, `@nekzus/liop` proporciona compatibilidad retroactiva directa con el Model Context Protocol (MCP) a través del módulo `LiopMcpBridge`. Para que esta integración sea inmediata, el paquete declara a `@modelcontextprotocol/sdk` en las dependencias opcionales y peer, lo que significa que las instalaciones estándar (`npm install @nekzus/liop`) lo resolverán e instalarán automáticamente de forma transparente.
Sin embargo, para entornos de producción restringidos (como contenedores Docker minimalistas, AWS Lambda o despliegues IoT) donde cada megabyte cuenta, puedes realizar una **instalación de LIOP pura y "zero-bloat"** omitiendo las dependencias opcionales:
```bash npm theme={null}
npm install @nekzus/liop@latest --no-optional
```
```bash pnpm theme={null}
pnpm add @nekzus/liop@latest --without optional
```
```bash yarn theme={null}
yarn add @nekzus/liop@latest --ignore-optional
```
Esto reduce drásticamente el peso de la instalación. El SDK utiliza `import()` dinámicos por debajo, lo que significa que la lógica del puente MCP solo se carga si es requerida por tu aplicación, manteniendo un consumo de memoria de ejecución impecable.
## Funcionamiento Interno: El Compilador Javy
Si LIOP 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 Industriales de Vanguardia
El SDK TypeScript mantiene paridad arquitectónica con el núcleo en Rust, asegurando restricciones Zero-Trust de grado profesional:
* **Criptografía Post-Cuántica (ML-KEM-768):** Encapsulación asimétrica de extremo a extremo (`crystals-kyber`) y autenticación simétrica AES-256-GCM.
* **Transporte de Malla Híbrido:** Conexión P2P sin restricciones para Node.js y navegadores a través de WebSockets (WS) y oyentes libp2p TCP (Yamux).
* **Guardian-TS (Inspección AST en Tiempo Cero):** Mitigación proactiva de escapes del sandbox que bloquea capacidades no autorizadas del host *antes* de que se active la lógica de ejecución `node:wasi`.
* **Listo para ZK-Receipt:** Soporte arquitectónico nativo para Pruebas Matemáticas de Ejecución sin confianza frente a Máquinas Virtuales de Conocimiento Cero (zkVMs).
* **Escalado Multi-Core (Pool de Workers):** Rendimiento transaccional acelerado por hardware usando `piscina`. Supera el cuello de botella del Event Loop de hilo único de V8 al delegar el descifrado PQC, la inspección AST y el Sandboxing WASI a hilos independientes a nivel de sistema operativo.
## Exportaciones Principales
El SDK exporta tres clases principales:
El receptor de datos. Expone capacidades locales y archivos, y maneja la intención de Logic-Injection-on-Origin de forma segura.
El nodo de inteligencia. Busca capacidades en la malla e inyecta payloads WASM para procesar datos.
El Traductor de Legado. Puentea instantáneamente `tools` y `resources` entre clientes MCP JSON-RPC heredados y tu red LIOP de alto rendimiento.
## Deep Dive: Pool Transaccional Multi-Core
LIOP rompe la limitación de hilo único de Node.js mediante el enrutamiento de la carga criptográfica a hilos aislados del SO.
## Comenzando
* Construye un [Data Server](/es/typescript-sdk/server) para proteger tus datos.
* Diseña un [Intelligence Client](/es/typescript-sdk/client) para buscar conocimiento en la malla.