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

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

FuenteContenedor
Anthropic MessagesUn mensaje con bloques de contenido; system es un parámetro de la solicitud, no un mensaje
OpenAI ResponsesUna lista plana de ítems tipados; un mensaje es un tipo de ítem entre muchos
ACP v1Sin objeto de mensaje: un stream de notificaciones session/update, con chunks agrupados por id de mensaje
Claude Agent SDK stream-jsonUna unión de 40 tipos de frame
Codex exec --jsonEventos 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.

CampoRol
seqPor conversación, sin huecos, asignado en la transacción de append para que un cliente pueda detectar pérdidas
idULID, único globalmente; el id de evento SSE
causation_idLa entrada o comando que causó el evento
idempotency_keyId de mensaje del cliente, o lease del productor, intento y secuencia
producerid, epoch, secuencia; un epoch obsoleto se rechaza (fencing)
occurred_atReloj del productor, solo diagnóstico, nunca se usa para ordenar
La regla de secuencia de la nota: un lock de fila sobre una conversación, de modo que las escrituras se serializan por conversación y en ningún otro lado.sql
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.