~/studies/work 2026-11-07 · published 2026-11-21
Una transcripción es un event log
Ningún protocolo maneja una CLI de agente y a la vez te deja ser dueño de la conversación. En qué discrepan los formatos de los proveedores, y una propuesta, no un build, de un stream de eventos append-only con números de secuencia sin huecos.
- agents
- transcripts
- event-log
- acp
- postgres
- ~/project/versatile-sh
La pregunta
¿Hay un punto medio entre ACP y las APIs de mensajes de los proveedores que permita a una plataforma mantener las conversaciones de su lado, tanto para APIs de modelos como para CLIs de agentes? El estudio corrió el 2026-11-07 y el 2026-11-08, leyendo código fuente en versiones fijadas: Claude Code 2.1.319 y su Agent SDK 0.3.319, el repositorio de Codex en d960b36, el esquema ACP 1.29.1 en 7441d10, el SDK de Anthropic 1.6.0, el SDK de OpenAI 7.53.0, y otros.
La respuesta, tal como la enuncia su registro: ningún protocolo habla con CLIs y a la vez mantiene una conversación que sea tuya. El hecho observado es que el resume depende del registro nativo de cada motor. Lo que sigue a la respuesta es una propuesta.
En qué discrepan los formatos
| Fuente | Contenedor |
|---|---|
| Anthropic Messages | Un mensaje con bloques de contenido; system es un parámetro de la solicitud, no un mensaje |
| OpenAI Responses | Una lista plana de ítems tipados; un mensaje es un tipo de ítem entre muchos |
| ACP v1 | Sin objeto de mensaje: un stream de notificaciones session/update, con chunks agrupados por id de mensaje |
| Claude Agent SDK stream-json | Una unión de 40 tipos de frame |
| Codex exec --json | Eventos de thread, turn e item; tipos de ítem en lugar de roles |
El razonamiento es donde más se separan. Anthropic lleva un bloque thinking legible con una firma, más thinking redactado. OpenAI tiene resúmenes de razonamiento y contenido cifrado opcional. ACP tiene chunks de pensamiento y ningún razonamiento opaco. Codex no lo expone en el stream de exec, aunque guarda contenido cifrado en su propio rollout. Un almacén que quiera cambiar de motor a mitad de conversación tiene que decidir qué hacer con un blob que solo un proveedor puede leer.
Una hipótesis que el estudio dejó abierta para probar con una clave real: si los blobs cifrados específicos de cada proveedor se validan solo para la misma organización y familia de modelos.
Replay no es un log
El Agent Protocol de LangChain guarda un historial de checkpoints por thread, que su README llama un log append-only de estados. Su streaming de threads, en cambio, dice que los servidores pueden mantener un ring buffer de eventos recientes y que, si la posición de un cliente fue desalojada, el cliente se resincroniza a través del estado. La lectura del estudio: el replay del stream en vivo es de mejor esfuerzo, y el registro durable es el historial de checkpoints.
Esa distinción es el punto de este post. Una transcripción a la que la gente se reconecta, de la que bifurca y que audita necesita lo durable, con el stream como una vista sobre ello.
La propuesta: un stream de ítems con un envelope
Propuesto, no construido: un stream de ítems modelado sobre Open Responses con los campos de tool-call de ACP, el payload crudo del proveedor guardado junto a cada ítem y adaptadores ACP oficiales detrás de un único cliente ACP en Go. Para la sincronización en vivo, una nota de diseño propone un envelope de eventos por conversación.
| Campo | Rol |
|---|---|
| seq | Por conversación, sin huecos, asignado en la transacción de append para que un cliente pueda detectar pérdidas |
| id | ULID, único globalmente; el id de evento SSE |
| causation_id | La entrada o comando que causó el evento |
| idempotency_key | Id de mensaje del cliente, o lease del productor, intento y secuencia |
| producer | id, epoch, secuencia; un epoch obsoleto se rechaza (fencing) |
| occurred_at | Reloj del productor, solo diagnóstico, nunca se usa para ordenar |
UPDATE conversation SET head_seq = head_seq + 1 WHERE id = $1 RETURNING head_seq;Los deltas de tokens no serían filas: llevan una posición dentro de la parte abierta y son efímeros, con un snapshot de la parte abierta enviado al reconectar. Las entradas también son eventos, con modos queue, steer e interrupt, y un solo titular del lease maneja una conversación a la vez.
Qué se ejecutó y qué no
Los formatos de los proveedores, las CLIs y otros productos se leyeron desde el código fuente. El esquema solo está especificado. El comportamiento de sesión en vivo de Claude Code, Codex, Goose y los adaptadores ACP se ejecutó offline contra servidores de modelo simulados locales con claves falsas, y la mayoría de las verificaciones se confirmaron. Un spike de un driver en Go confirmó steering, aprobaciones firmadas y resume sobre los adaptadores oficiales claude-agent-acp y codex-acp.
Abierto: si inyectar ítems en un thread nuevo de Codex basta para continuar una conversación guardada solo en tu propia base de datos, y si un daemon puede manejar un Claude Code con sesión de suscripción, que es una cuestión de términos para los proveedores. El diseño de secuencia y envelope es una propuesta sin ninguna medición detrás.