~/studies/work 2026-11-07 · published 2026-11-21
Uma transcrição é um event log
Nenhum protocolo conduz uma CLI de agente e ao mesmo tempo deixa você ser dono da conversa. No que os formatos dos fornecedores divergem, e uma proposta, não um build, de um stream de eventos append-only com números de sequência sem lacunas.
- agents
- transcripts
- event-log
- acp
- postgres
- ~/project/versatile-sh
A pergunta
Existe um meio-termo entre o ACP e as APIs de mensagens dos fornecedores que permita a uma plataforma manter as conversas do seu lado, tanto para APIs de modelos quanto para CLIs de agentes? O estudo rodou em 2026-11-07 e 2026-11-08, lendo código-fonte em versões fixadas: Claude Code 2.1.319 e seu Agent SDK 0.3.319, o repositório do Codex em d960b36, o esquema ACP 1.29.1 em 7441d10, o SDK da Anthropic 1.6.0, o SDK da OpenAI 7.53.0, e outros.
A resposta, como o registro a enuncia: nenhum protocolo fala com CLIs e ao mesmo tempo mantém uma conversa que seja sua. O fato observado é que o resume depende do registro nativo de cada motor. O que vem depois da resposta é uma proposta.
No que os formatos divergem
| Fonte | Contêiner |
|---|---|
| Anthropic Messages | Uma mensagem com blocos de conteúdo; system é um parâmetro da requisição, não uma mensagem |
| OpenAI Responses | Uma lista plana de itens tipados; uma mensagem é um tipo de item entre vários |
| ACP v1 | Sem objeto de mensagem: um stream de notificações session/update, com chunks agrupados por id de mensagem |
| Claude Agent SDK stream-json | Uma união de 40 tipos de frame |
| Codex exec --json | Eventos de thread, turn e item; tipos de item em vez de papéis |
O raciocínio é onde eles mais se separam. A Anthropic carrega um bloco thinking legível com uma assinatura, mais thinking redigido. A OpenAI tem resumos de raciocínio e conteúdo criptografado opcional. O ACP tem chunks de pensamento e nenhum raciocínio opaco. O Codex não o expõe no stream do exec, embora guarde conteúdo criptografado no seu próprio rollout. Um armazém que queira trocar de motor no meio da conversa precisa decidir o que fazer com um blob que só um fornecedor consegue ler.
Uma hipótese que o estudo deixou em aberto para testar com uma chave real: se os blobs criptografados específicos de cada fornecedor só validam para a mesma organização e família de modelos.
Replay não é um log
O Agent Protocol do LangChain guarda um histórico de checkpoints por thread, que o README chama de log append-only de estados. O streaming de threads dele, por outro lado, diz que os servidores podem manter um ring buffer de eventos recentes e que, se a posição de um cliente foi descartada, o cliente ressincroniza pelo estado. A leitura do estudo: o replay do stream ao vivo é de melhor esforço, e o registro durável é o histórico de checkpoints.
Essa distinção é o ponto deste post. Uma transcrição à qual as pessoas se reconectam, da qual fazem branch e que auditam precisa do durável, com o stream como uma visão sobre ele.
A proposta: um stream de itens com um envelope
Proposto, não construído: um stream de itens modelado sobre o Open Responses com os campos de tool-call do ACP, o payload bruto do fornecedor guardado junto de cada item e adaptadores ACP oficiais atrás de um único cliente ACP em Go. Para a sincronização ao vivo, uma nota de design propõe um envelope de eventos por conversa.
| Campo | Papel |
|---|---|
| seq | Por conversa, sem lacunas, atribuído na transação de append para que um cliente detecte perdas |
| id | ULID, globalmente único; o id de evento SSE |
| causation_id | A entrada ou comando que causou o evento |
| idempotency_key | Id de mensagem do cliente, ou lease do produtor, tentativa e sequência |
| producer | id, epoch, sequência; um epoch obsoleto é rejeitado (fencing) |
| occurred_at | Relógio do produtor, só diagnóstico, nunca usado para ordenar |
UPDATE conversation SET head_seq = head_seq + 1 WHERE id = $1 RETURNING head_seq;Os deltas de tokens não seriam linhas: carregam uma posição dentro da parte aberta e são efêmeros, com um snapshot da parte aberta enviado na reconexão. As entradas também são eventos, com modos queue, steer e interrupt, e um único detentor do lease conduz uma conversa por vez.
O que foi executado e o que não foi
Os formatos dos fornecedores, as CLIs e outros produtos foram lidos a partir do código-fonte. O esquema é apenas especificado. O comportamento de sessão ao vivo do Claude Code, do Codex, do Goose e dos adaptadores ACP foi executado offline contra servidores de modelo simulados locais com chaves falsas, e a maioria das checagens foi confirmada. Um spike de um driver em Go confirmou steering, aprovações assinadas e resume sobre os adaptadores oficiais claude-agent-acp e codex-acp.
Em aberto: se injetar itens em uma thread nova do Codex basta para continuar uma conversa guardada apenas no seu próprio banco de dados, e se um daemon pode conduzir um Claude Code logado por assinatura, o que é uma questão de termos com os fornecedores. O design de sequência e envelope é uma proposta sem nenhuma medição por trás.