~/studies/work 2026-11-08 · published 2026-11-21
Cómo hablan los agentes con las CLIs y entre sí
Dos estudios de solo lectura de runtimes de agentes open source: las capas entre una cola de tareas y una CLI de agente, cómo Paperclip y Multica llaman a los agentes, y cómo se ve la delegación cuando un agente le pasa trabajo a otro.
- agents
- acp
- delegation
- sub-agents
- protocols
- ~/project/versatile-sh
Qué se leyó
Dos estudios, ambos sobre código leído el 2026-11-07 y el 2026-11-08: cómo tres runtimes hablan con CLIs de agentes, y cómo delegan los equipos de agentes. Los tres runtimes son Paperclip upstream en el commit 177f642, Multica en 4239ec1 y un fork de Paperclip que mantenemos. No se construyó nada y no se ejecutó nada. Cada hallazgo de abajo está etiquetado como observado, por lectura de código, o propuesto.
Cuatro capas entre una cola y un agente
El fork tiene cuatro capas de ejecución, y una ejecución elige una en el dispatch. Una capa de heartbeat es dueña de la cola, el claim y el almacenamiento de resultados. Una capa de adapters tiene un módulo por tipo de adapter, dueño del spawn, HTTP o WebSocket y el parseo de la salida. Dentro de un adapter, un engine es cli (lanzar la CLI, parsear su JSON delimitado por saltos de línea) o acp (el Agent Client Protocol, JSON-RPC sobre stdio). Al lado hay un native runner separado, un daemon en Rust que habla su propio protocolo sobre un WebSocket autenticado, y un edge daemon que toma tareas arrendadas desde el lado del cliente.
Observado: ACP ya es el engine por defecto para Codex, Gemini y Kimi en ese fork, mientras que los perfiles de permisos bloquean solo el adapter de la CLI de Claude. El contrato de adapters está versionado, y upstream y el fork comparten los mismos doce paquetes de adapters legacy.
El punto de fork estaba 1,916 commits de upstream por detrás al momento de la lectura, creciendo en aproximadamente 70 al día durante 27 días, según una llamada compare del 2026-11-07. La única propuesta que el estudio de wiring hizo con esa evidencia fue una hipótesis: hacer cherry-pick de las correcciones de upstream en lugar de merge.
Multica: el agente llama de vuelta
Multica es un servidor Go con un daemon que detecta CLIs de agentes locales y las lanza. Una interfaz Go, Backend.Execute, devuelve una sesión con un stream de mensajes normalizado: text, thinking, tool use, tool result, status, error, log. El registro contó 28 familias de providers en código, más un runtime derivado.
El patrón de comunicación difiere del fork. El agente le habla de vuelta al servidor llamando a una CLI multica sobre HTTPS con un token por tarea. El daemon también expone un endpoint HTTP loopback para el checkout de repositorios. Así que la superficie de tools del agente es una CLI que entrega la plataforma, no un servidor MCP.
Delegación: en qué convergieron los practicantes
El estudio de equipos leyó unos 30 frameworks y productos. Su primer hallazgo, con fuentes que incluyen escritos de Anthropic y Cognition y la taxonomía de fallos MAST: los practicantes convergen en delegación manager-hijo con un solo escritor por artefacto. La negociación entre pares y los escritores paralelos fallan. La misma nota pone el costo multi-agente en unas 15 veces los tokens de un chat, una cifra que toma de esas fuentes secundarias, no de una medición propia.
- Ningún framework dio a los agentes una identidad real ni un principal on-behalf-of. La identidad era una cadena de nombre.
- Las aprobaciones eran por llamada a tool, nunca a nivel de equipo.
- Solo AG2 v1 contaba la profundidad de delegación (límite 5). Solo ADK registraba la estructura del equipo en cada evento y trataba la salida de pares como no confiable.
- Cada engine modelaba un sub-agente como una llamada a tool en el padre más una sesión hija con su propio id. Dirigir a un hijo desde el host era casi siempre imposible.
Dos huecos confirmados en el fork
El fork tenía la guarda de delegación más fuerte de los tres productos: política por línea, un log de hand-off, un tope de 3 saltos y un interruptor de autonomía del equipo que falla cerrado. También tenía los valores por defecto más peligrosos. Los agentes podían contratar agentes con la aprobación apagada, un presupuesto de 0 significaba ilimitado y ninguna fila de política significaba ningún límite.
Confirmado leyendo código: su tool delegate_task se saltaba el permiso de asignación y la comprobación de contact-policy que la asignación REST sí aplica. Y su auth de desarrollo trataba a cualquier peer loopback como el owner. El 2026-11-08 el owner decidió no corregir esto en ese producto y convertirlo en requisitos para el nuevo.
Lo que es solo una propuesta
El estudio propuso filas explícitas de equipo y de delegación, un servicio de delegación como único camino y autoridad que se estrecha en cada salto, de modo que un hijo solo pueda restringir lo que le pasó el padre. Catorce preguntas de diseño fueron al owner. Sus recomendaciones, por ejemplo un tope de profundidad de 3 con una profundidad por defecto de 1, un tope de 4 en vuelo y un tope de vida de 50 por conversación padre, son recomendaciones. Seguían abiertas cuando me detuve, y ninguna se probó.
No probado: si un core puede cumplir el plazo de primera actividad de 10 segundos de Linear cuando el agente corre en un edge daemon, contexto solo con brief, topes de engine por ejecución, valores por defecto de fan-out y stall, y routing basado en reglas. Todas son hipótesis.