LIOP Agent (CLI)

Pasarela de seguridad Zero-Config para aplicaciones de IA de escritorio

El LIOP Agent es una utilidad de línea de comandos lista para producción incluida en el paquete @nekzus/liop. Actúa como un puente entre las interfaces de IA estándar (como Claude Desktop o Cursor) y el protocolo descentralizado Logic-Injection-on-Origin Protocol.

En lugar de programar un servidor personalizado, los usuarios pueden simplemente ejecutar el agente para obtener instantáneamente capacidades de “Logic-Injection-on-Origin”.

​

Instalación

El agente se distribuye a través del paquete principal del SDK. Puedes ejecutarlo directamente usando npx:

npx -y @nekzus/liop@latest

O instalarlo globalmente para tener el comando liop disponible en todo el sistema:

npm install -g @nekzus/liop@latest
liop

​

Integración con Claude Desktop

LIOP está diseñado para ser un reemplazo directo de los servidores MCP. Para añadir las herramientas de la red LIOP a tu experiencia en Claude Desktop, actualiza tu archivo de configuración:

Windows (%APPDATA%\Claude\claude_desktop_config.json)

{
  "mcpServers": {
    "liop": {
      "command": "npx",
      "args": ["-y", "@nekzus/liop@latest"],
      "env": {
        "LIOP_NEXUS_URL": "http://tu-nexus-host:3000",
        "LIOP_TOKEN_BANK": "tu-token-banco-aqui",
        "LIOP_TOKEN_VAULT": "tu-token-boveda-aqui",
        "LIOP_LOG_LEVEL": "info",
        "NODE_OPTIONS": "--use-system-ca"
      }
    }
  }
}

Una vez configurado, reinicia Claude Desktop. Verás el estado LIOP Guard en tus logs de error indicando que la malla está activa.

​

Características Principales

​

1. Persistencia de Identidad

El agente genera un PeerID único (par de claves Ed25519) la primera vez que se ejecuta. Esta identidad se almacena en: ~/.liop/identity.json

[!IMPORTANT] Si cambias de máquina, copiar esta carpeta te permitirá mantener tu reputación y accesos verificados en la red.

​

2. Enrutamiento Autónomo

El agente utiliza el LiopMcpRouter internamente. Cuando recibe una llamada de herramienta desde Claude:

1. Consulta la red P2P descentralizada para encontrar nodos que provean esa herramienta.
2. Establece un túnel seguro Kyber768 + AES-256-GCM.
3. Inyecta la lógica en el servidor remoto y devuelve el resultado verificado binariamente.

​

3. Descubrimiento de Bootstrap

Por defecto, el agente se conecta al nodo LIOP Alpha Nexus. Si se requiere una infraestructura personalizada, puede apuntar a cualquier nodo bootstrap de la red:

npx @nekzus/liop@latest /ip4/1.2.3.4/tcp/4001/p2p/PEER_ID

​

Seguridad y Diagnóstico

El agente solo se comunica a través de STDIO. Imprime logs de estado y eventos de descubrimiento estrictamente en stderr, asegurando que el canal stdout permanezca limpio para los mensajes JSON-RPC 2.0 requeridos por el cliente LLM.

​

Diagnóstico Local de Malla (LiopMeshStatus)

El agente expone automáticamente una herramienta de diagnóstico local llamada LiopMeshStatus. Cuando un LLM invoca esta herramienta, el agente la intercepta localmente en lugar de enrutarla por la red P2P. Retorna un informe estructurado de estado operativo que incluye:

• Bootstrappers conectados y Peer IDs
• Nodos activos (Vault, Bank, Oracle)
• Tablas de enrutamiento de herramientas y estado de la Kademlia DHT
• Consumo de tokens y estimaciones de telemetría

Esto permite a los clientes de IA autodiagnosticar caídas de conexión o verificar qué herramientas están disponibles sin sobrecargar el ancho de banda de la red ni duplicar peticiones de diagnóstico a través de múltiples nodos.

​

Variables de Entorno

El comportamiento del agente se puede personalizar mediante las siguientes variables de entorno:

Variable	Por defecto	Descripción
LIOP_NEXUS_URL	(ninguno)	URL del nodo Nexus para Auto-Discovery. El agente resuelve el PeerID y el multiaddr desde el endpoint /health automáticamente
LIOP_LOG_LEVEL	info	Controla la verbosidad de los logs (silent, info, debug). Establecer en silent para suprimir toda la salida stderr
LIOP_EXPECTED_PROVIDERS	1	Número de proveedores de la malla a esperar durante el warm-up inicial. El polling adaptativo DHT continúa descubriendo proveedores adicionales en segundo plano
LIOP_INITIAL_DISCOVERY_TIMEOUT_MS	8000	Tiempo máximo (ms) a esperar durante la fase inicial de descubrimiento de la malla antes de continuar
LIOP_MCP_COMPACT_TOOL_DESCRIPTIONS	true	Elimina metadatos verbosos del protocolo en las descripciones de herramientas, reduciendo el consumo de tokens en ~500 por herramienta. Establecer en 0 para desactivar
LIOP_GRPC_PORT	50051	Sobreescribe el puerto gRPC por defecto del servidor RPC interno
LIOP_WORKER_MAX_HEAP_MB	64	Tamaño máximo del heap V8 por thread worker (defensa contra Heap Bomb)
LIOP_QUERY_BUDGET	(ninguno)	Sobrescritura de presupuesto de consultas por sesión para pruebas de auditoría analítica de alta frecuencia
LIOP_DOCKER_MAP	false	Fuerza la traducción de IPs internas de contenedores Docker (172.x.x.x) a la dirección loopback del host (127.0.0.1), mapeando los servicios gRPC de los nodos a los puertos publicados en el host para poder ejecutar demos locales con contenedores aislados
LIOP_DEV_MODE	false	Activa heurísticas de desarrollo que automatizan el mapeo de puertos Docker si la URL de Nexus apunta a puertos típicos de la demo local (13000/13001)
LIOP_DATASET_SCALE	1	Factor de escala utilizado por los nodos de prueba y demo para escalar dinámicamente el tamaño de generación de registros sintéticos (ej. transacciones bancarias, registros médicos)

​

Compatibilidad de Handshake MCP Dual-Era

El LIOP Agent satisface de forma nativa los protocolos de clientes MCP modernos y heredados:

• Revisión MCP v2 (2026-07-28):
  • Responde a sondas server/discover sin autenticación para descubrimiento de herramientas sin estado.
  • Incluye automáticamente el campo obligatorio resultType: "complete" en las respuestas de tools/list.
  • Gestiona subscriptions/listen y resources/templates/list sin sobrecarga de sondeo.
• Era Heredada MCP (2025-11-25):
  • Purga metadatos de la versión v2 mediante adaptResponseForLegacyClient() para evitar fallos de deserialización en clientes de escritorio tradicionales.

LIOP_BOOTSTRAP_FILE se considera obsoleta desde v2.0.0-alpha. Usa LIOP_NEXUS_URL en su lugar. El agente emite una advertencia si detecta esta variable.

---

​

Integración Programática de la Malla (MeshNode)

Los desarrolladores que integran LIOP en servicios backend personalizados pueden instanciar y gestionar MeshNode directamente sin invocar el ejecutable CLI:

import { MeshNode } from "@nekzus/liop";

const mesh = new MeshNode({
  listenAddresses: ["/ip4/0.0.0.0/tcp/4001"],
  bootstrapNodes: [
    "/ip4/127.0.0.1/tcp/15001/p2p/12D3KooW..."
  ],
  enableWAN: false,
  enableAutoNAT: true,
  enableRelay: true,
});

await mesh.start();
console.log("Peer ID local:", mesh.getPeerId());

// Descubrir enclaves remotos que anuncian una capacidad de herramienta específica
const providers = await mesh.findProviders("tool:execute_anomaly_audit");

// Consultar el manifiesto firmado de un nodo remoto sobre /liop/manifest/1.0.0
for (const peerId of providers) {
  const manifest = await mesh.queryManifest(peerId);
  console.log(`Herramientas descubiertas en ${peerId}: ${manifest?.tools.length}`);
}

// Cierre ordenado
await mesh.stop();

​

Métodos Públicos Principales

Método	Tipo de Retorno	Descripción
start()	Promise<void>	Inicializa los transportes libp2p, criptografía Noise y la tabla de enrutamiento Kademlia
stop()	Promise<void>	Cierra todas las conexiones del enjambre y limpia el estado de enrutamiento de la DHT
getPeerId()	string	Retorna el identificador Peer ID Ed25519 del nodo local
getMultiaddrs()	string[]	Retorna las direcciones multiaddr enlazadas en los transportes activos (TCP/WS)
findProviders(capability)	Promise<string[]>	Consulta la DHT Kademlia para encontrar Peer IDs que anuncien una capacidad
queryManifest(target)	Promise<LiopManifest | null>	Obtiene directamente el manifiesto JSON firmado desde un par remoto
announceManifest(manifest)	Promise<void>	Publica las capacidades locales en la DHT y registra el manejador del protocolo de manifiesto

Si encuentras problemas de conexión, busca el mensaje de LIOP Guard en la consola o pídele al LLM que ejecute LiopMeshStatus.