Cápsula de Continuidade v1

Um objeto JSON entre a morte e o recomeço frio.

Um formato aberto de handoff. Grátis para emitir, grátis para ler, versionado e publicado como JSON Schema para nenhum agente ter que adivinhar o formato.

Validar uma cápsula Abrir o schema

Anatomia

Os campos.

Seis deles são os mesmos seis de uma boa passagem de plantão humana. O sétimo — refutado — é o que quase todo formato esquece, e o que impede a próxima sessão de pagar duas vezes pelo mesmo beco sem saída.

`version`

stringSempre "1" na v1.

`goal`

stringO que esta execução tentava alcançar.

`done`

stringO que está pronto e verificado — não o que foi tentado.

`next`

stringA próxima ação, concreta o bastante para começar do zero.

`blockers`

stringO que travou, e em quem ou no quê.

`do_not`

stringRestrições que a próxima sessão não pode violar.

`refuted`

stringHipóteses já descartadas, com o porquê. O campo que mais economiza tokens.

`receipts`

string[]Ponteiros para evidência: commits, ids de deploy, urls de execução.

`written_by`

stringQual agente selou esta trilha.

`written_at`

stringTimestamp ISO; a retomada mostra a idade.

`ttl_days`

string | intPor quanto tempo quem escreveu considera isto útil.

`handoff_to`

stringOpcional: o destinatário pretendido.

Exemplo

Uma cápsula real.

É assim que um handoff no meio de uma migração fica quando é escrito para ser lido.

capsule.json

{
  "version": "1",
  "goal": "Migrate the billing module to the new client",
  "done": "Adapters written, unit tests green, staging deploy verified",
  "next": "Swap the callsites in checkout, then delete the shim",
  "blockers": "Staging secret STRIPE_KEY_V2 is missing",
  "do_not": "Do not delete the shim before the callsites move",
  "refuted": "Batching the migration fails — the old client is not idempotent",
  "receipts": ["repo@a1b2c3d", "staging deploy 2026-08-08T11:04Z"],
  "written_by": "acme-refactor-bot",
  "ttl_days": 14
}

Validador

Valide a sua.

Nada sai do seu navegador. As regras abaixo espelham o schema publicado e as travas de escrita que a API aplica.

Cole uma cápsula

Cole uma cápsula acima, ou carregue o exemplo.

Regras espelhadas do schema publicado; a autoridade continua sendo a API.

JSON Schema

O schema.

Baixe, gere tipos a partir dele ou valide contra ele no CI.

curl

curl https://api.delx.ai/schemas/continuity-capsule-v1.json

Uma cápsula é guardada como chaves de memória hive.* na sessão que escreveu e devolvida à próxima sessão do mesmo agent_id estável. Não é feed público, não é mural compartilhado e não é indexada em lugar nenhum. Frotas são a única exceção, e só para membros que entraram com token de convite.

FAQ

Respostas diretas.

O formato da Cápsula de Continuidade é aberto?

Sim. O JSON Schema é publicado numa URL estável, versionado e livre para implementar. Qualquer agente de qualquer fornecedor pode emitir ou consumir uma cápsula sem usar a Delx para guardá-la.

Para que serve o campo refuted?

Ele registra hipóteses já descartadas e o motivo. É o campo de maior valor num handoff porque impede a sessão seguinte de gastar contexto re-derivando um beco sem saída que a anterior já pagou.

O que acontece se uma cápsula tiver um segredo?

A escrita é recusada antes do armazenamento. Valores com cara de credencial são detectados e rejeitados com uma explicação que nunca repete o valor, e nada é registrado em log.

Qual o tamanho máximo de uma cápsula?

Cada campo de texto tem limite de 4.000 caracteres e uma sessão comporta até 16 chaves hive. Os limites existem para a trilha continuar legível pelo próximo agente em vez de virar despejo de transcrição.