Agent Tools Runtime
Runtime persistente basado en just-bash para que un agente descubra y cargueprogresivamente adaptadores MCP, REST y CLI local sin exponer todo el catálogode herramientas en cada conversación.
Estado
Este repositorio es la evolución independiente de la POC publicada enTheHumanInTheLoop Marketplace.La API todavía está en 0.x; cualquier cambio puede requerir migración.
Capas
MCP facade → persistent runtime → adapter → provider
Adaptadores incluidos:
- MCP genérico con sesiones y tokens host-side.
- n8n MCP con OAuth/token host-side.
- REST/API con rutas relativas y confirmación para mutaciones.
- CLI local con allowlist,
execFile, timeout y confirmación.
Desarrollo
Requisitos: Node.js >=20.18.1.
npm install
npm test
npm run probe
npm run serve
La fachada MCP se inicia con:
npm run mcp
Instalación desde una release
El paquete está publicado en npm como@rckflr/agent-tools-runtime:
npm install @rckflr/agent-tools-runtime
Para iniciar la fachada MCP sin instalarla globalmente:
npx --yes --package=@rckflr/[email protected] --call agent-tools-mcp
Si ejecutas el comando desde el propio checkout agent-tools-runtime, usa elprefijo del directorio padre para que npm no confunda el paquete local con elpaquete remoto:
npx --prefix .. --yes --package=@rckflr/[email protected] --call agent-tools-mcp
La release inicial también incluye un tarball instalable directamente desdeGitHub:
npm install https://github.com/MauricioPerera/agent-tools-runtime/releases/download/v0.1.0/rckflr-agent-tools-runtime-0.1.0.tgz
Después de instalarlo, el ejecutable queda disponible como agent-tools.El repositorio incluye un workflow de publicación. Para futuras versiones sedebe configurar el secret NPM_TOKEN en GitHub; después puede ejecutarsemanualmente o al publicar una release con tag v*.
El preflight puede comprobar un CLI sin ejecutarlo:
$env:AGENT_TOOLS_COMMAND = "gh"
$env:AGENT_CLI_ALLOWLIST = "gh,docker,supabase"
npm run probe
Diseño de seguridad
Las credenciales permanecen en el host. Las skills y los adapters no debenrecibir tokens como argumentos ni escribir secretos en archivos. Lasoperaciones mutantes requieren confirmación explícita y los CLIs se ejecutansin shell implícito.
Integraciones
El plugin para Claude Code y Codex se mantiene en el marketplace como una capade distribución. Este repositorio contiene el runtime canónico y no depende delos manifests específicos de ningún cliente.
Licencia
MIT. Consulta LICENSE.
