Guarda el estado del agente en la nube, no en un archivo JSON local
Puntos de control, listas de elementos procesados y bitácoras de ejecución que sobreviven a una sesión nueva, a una computadora nueva o a un agente que falló, con reintentos que nunca se aplican dos veces.
Actualizado
Los agentes que trabajan durante más de una sesión guardan estado: qué elementos están listos, dónde se detuvo un trabajo largo, qué pasó en cada ejecución. Normalmente eso es un state.json junto al agente. Se pierde con la máquina, otros agentes no pueden verlo y dos ejecuciones se sobrescriben entre sí. Tunc Orb guarda ese mismo estado en la nube, con reglas que hacen seguras las escrituras simultáneas y los reintentos.
Registros para el estado actual
Un registro contiene un valor: JSON, texto o binario, de hasta 16 MiB. Créalo una vez y luego modifícalo sobre la revisión que leíste por última vez. Una revisión desactualizada se rechaza con revision_conflict, así que dos agentes nunca se sobrescriben en silencio: el que pierde vuelve a leer y decide de nuevo.
curl -s https://api.tuncorb.com/v1/write \
-H "Authorization: Bearer $TUNC_API_KEY" -H "Content-Type: application/json" \
-d '{"operation":"create","name":"jobs/import/checkpoint",
"about":"Where the nightly import stopped",
"value":{"cursor":"2026-10-23T00:00:00Z","done":[]},
"mutation_id":"mut_<26 lowercase base32 characters, new for each change>"}'Para cambiar parte de un registro JSON, envía un JSON Patch (add, remove, replace, test). Si alguna operación falla, no cambia nada:
curl -s https://api.tuncorb.com/v1/write \
-H "Authorization: Bearer $TUNC_API_KEY" -H "Content-Type: application/json" \
-d '{"operation":"patch","name":"jobs/import/checkpoint","if_revision":"rev_…",
"patch":[{"op":"replace","path":"/cursor","value":"2026-10-24T00:00:00Z"},
{"op":"add","path":"/done/-","value":"batch-17"}],
"mutation_id":"mut_<26 lowercase base32 characters, new for each change>"}'Bitácoras para lo que pasó
Una bitácora es de solo anexado: cada anexado agrega de 1 a 100 entradas (hasta 64 KiB) y el servicio asigna sus ID y su orden. Dale a una entrada un event_key, como el ID del mensaje de origen: volver a enviar la misma clave con contenido idéntico devuelve la entrada original en lugar de un duplicado, mientras que enviar contenido distinto con la misma clave se rechaza con event_key_conflict y arrastra consigo el resto de ese lote.
curl -s https://api.tuncorb.com/v1/write \
-H "Authorization: Bearer $TUNC_API_KEY" -H "Content-Type: application/json" \
-d '{"operation":"append","name":"jobs/import/runs","about":"One entry per nightly import run",
"entries":[{"value":{"rows":1204,"status":"ok"},"event_key":"run-2026-10-24"}],
"mutation_id":"mut_<26 lowercase base32 characters, new for each change>"}'Los reintentos nunca se aplican dos veces
Cada cambio lleva un mutation_id. Si una solicitud agota el tiempo de espera y no sabes si llegó, vuelve a enviarla con el mismo mutation_id, o consulta su resultado con data_read y la operación status. El cambio se aplica una sola vez.
Desde tu propio código
Crea una clave de API en https://tunchub.com/account/keys/new y envíala como token Bearer a https://api.tuncorb.com (POST /v1/read, /v1/write, /v1/delete). Los agentes en claude.ai, ChatGPT, Claude Code, Cursor y VS Code usan el mismo almacén a través de https://mcp.tuncorb.com/mcp, así que un script y un agente pueden compartir un mismo punto de control.
- Por MCP remoto, un solo valor tiene como máximo 64 KiB; guarda los archivos más grandes en Tunc Art y almacena su artifact_id en un registro.
- Por agente, cada segundo: 50 lecturas, 20 guardados, 5 búsquedas. Las ráfagas cortas no son problema.
- Gratis: 1 GB de almacenamiento compartido por Tunc Hub, Tunc Art y Tunc Orb, con 50.000 operaciones de Tunc Orb al día.
