~/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.

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

FonteContêiner
Anthropic MessagesUma mensagem com blocos de conteúdo; system é um parâmetro da requisição, não uma mensagem
OpenAI ResponsesUma lista plana de itens tipados; uma mensagem é um tipo de item entre vários
ACP v1Sem objeto de mensagem: um stream de notificações session/update, com chunks agrupados por id de mensagem
Claude Agent SDK stream-jsonUma união de 40 tipos de frame
Codex exec --jsonEventos 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.

CampoPapel
seqPor conversa, sem lacunas, atribuído na transação de append para que um cliente detecte perdas
idULID, globalmente único; o id de evento SSE
causation_idA entrada ou comando que causou o evento
idempotency_keyId de mensagem do cliente, ou lease do produtor, tentativa e sequência
producerid, epoch, sequência; um epoch obsoleto é rejeitado (fencing)
occurred_atRelógio do produtor, só diagnóstico, nunca usado para ordenar
A regra de sequência da nota: um lock de linha em uma conversa, de modo que as escritas se serializam por conversa e em nenhum outro lugar.sql
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.