~/studies/work 2026-11-08 · published 2026-11-21
Como agentes conversam com CLIs e entre si
Dois estudos somente de leitura de runtimes de agentes open source: as camadas entre uma fila de tarefas e uma CLI de agente, como Paperclip e Multica chamam agentes, e como é a delegação quando um agente passa trabalho para outro.
- agents
- acp
- delegation
- sub-agents
- protocols
- ~/project/versatile-sh
O que foi lido
Dois estudos, ambos sobre código lido em 2026-11-07 e 2026-11-08: como três runtimes conversam com CLIs de agentes, e como equipes de agentes delegam. Os três runtimes são o Paperclip upstream no commit 177f642, o Multica em 4239ec1 e um fork do Paperclip que mantemos. Nada foi construído e nada foi rodado. Cada achado abaixo está rotulado como observado, por leitura de código, ou proposto.
Quatro camadas entre uma fila e um agente
O fork tem quatro camadas de execução, e uma execução escolhe uma no dispatch. Uma camada de heartbeat é dona da fila, do claim e do armazenamento de resultados. Uma camada de adapters tem um módulo por tipo de adapter, dono do spawn, de HTTP ou WebSocket e do parsing da saída. Dentro de um adapter, um engine é cli (iniciar a CLI, parsear seu JSON delimitado por quebras de linha) ou acp (o Agent Client Protocol, JSON-RPC sobre stdio). Ao lado fica um native runner separado, um daemon em Rust que fala o próprio protocolo sobre um WebSocket autenticado, e um edge daemon que puxa tarefas alugadas do lado do cliente.
Observado: ACP já é o engine padrão para Codex, Gemini e Kimi nesse fork, enquanto os perfis de permissão travam só o adapter da CLI do Claude. O contrato de adapters é versionado, e o upstream e o fork compartilham os mesmos doze pacotes de adapters legados.
O ponto de fork estava 1,916 commits atrás do upstream na hora da leitura, crescendo cerca de 70 por dia ao longo de 27 dias, segundo uma chamada compare de 2026-11-07. A única proposta que o estudo de wiring fez com essa evidência foi uma hipótese: fazer cherry-pick das correções do upstream em vez de merge.
Multica: o agente chama de volta
Multica é um servidor Go com um daemon que detecta CLIs de agentes locais e as inicia. Uma interface Go, Backend.Execute, devolve uma sessão com um stream de mensagens normalizado: text, thinking, tool use, tool result, status, error, log. O registro contou 28 famílias de providers no código, mais um runtime derivado.
O padrão de comunicação difere do fork. O agente fala de volta com o servidor chamando uma CLI multica por HTTPS com um token por tarefa. O daemon também expõe um endpoint HTTP loopback para o checkout de repositórios. Então a superfície de tools do agente é uma CLI que a plataforma entrega, não um servidor MCP.
Delegação: em que os praticantes convergiram
O estudo de equipes leu cerca de 30 frameworks e produtos. O primeiro achado, com fontes que incluem textos da Anthropic e da Cognition e a taxonomia de falhas MAST: os praticantes convergem em delegação manager-filho com um único escritor por artefato. Negociação entre pares e escritores paralelos falham. A mesma nota põe o custo multi-agente em cerca de 15 vezes os tokens de um chat, um número que ela toma dessas fontes secundárias, não de uma medição própria.
- Nenhum framework deu aos agentes uma identidade real nem um principal on-behalf-of. A identidade era uma string de nome.
- As aprovações eram por chamada de tool, nunca em nível de equipe.
- Só o AG2 v1 contava a profundidade de delegação (limite 5). Só o ADK registrava a estrutura da equipe em cada evento e tratava a saída de pares como não confiável.
- Todo engine modelava um sub-agente como uma chamada de tool no pai mais uma sessão filha com id próprio. Conduzir um filho a partir do host era quase sempre impossível.
Dois buracos confirmados no fork
O fork tinha a guarda de delegação mais forte dos três produtos: política por linha, um log de hand-off, um teto de 3 saltos e uma chave de autonomia da equipe que falha fechada. Também tinha os padrões mais perigosos. Agentes podiam contratar agentes com a aprovação desligada, um orçamento de 0 significava ilimitado e nenhuma linha de política significava nenhum limite.
Confirmado lendo código: sua tool delegate_task pulava a permissão de atribuição e a checagem de contact-policy que a atribuição REST aplica. E sua auth de desenvolvimento tratava qualquer peer loopback como o owner. Em 2026-11-08 o owner decidiu não corrigir isso naquele produto e transformá-los em requisitos para o novo.
O que é só proposta
O estudo propôs linhas explícitas de equipe e de delegação, um serviço de delegação como único caminho e autoridade que se estreita a cada salto, de modo que um filho só possa restringir o que o pai passou. Catorze perguntas de design foram para o owner. As recomendações, por exemplo um teto de profundidade de 3 com profundidade padrão de 1, um teto de 4 em andamento e um teto de vida de 50 por conversa pai, são recomendações. Ainda estavam abertas quando parei, e nenhuma foi testada.
Não testado: se um core consegue cumprir o prazo de primeira atividade de 10 segundos do Linear quando o agente roda em um edge daemon, contexto só com brief, tetos de engine por execução, padrões de fan-out e stall, e routing baseado em regras. Todas são hipóteses.