Quando um agente responde “está no ar”, três objetos participaram do trabalho: o Site, a Session e a Version publicada.

Site é o produto publicado

Cada Site tem slug, URL pública e repositório. O diretório public/ contém tudo o que a URL serve. Arquivos de notas, instruções ou rascunhos podem ficar fora de public/ sem aparecer na web.

Session é a área de edição

A primeira file tool inicia uma Session automaticamente. write, edit e bash alteram os arquivos da Session, que ficam guardados até o próximo deploy.

Isso permite que o agente leia, altere, compare e corrija sem publicar a cada passo. A Session não expira: o trabalho continua lá na próxima conversa.

File tools mantêm o contexto no Site

O agente não precisa montar um pacote intermediário para cada alteração. Ele trabalha diretamente com caminhos como:

public/index.html
public/css/site.css
public/assets/logo.svg
public/sitemap.xml

edit exige correspondência exata do texto antigo e aplica várias edições de forma atômica. bash com rg e find ajuda a localizar referências antes de renomear ou remover arquivos.

Deploy cria uma Version

Quando a revisão termina, deploy publica o diretório public/. O Site no Ar transforma o trabalho da Session em um commit único no histórico principal.

Uma Version preserva mensagem, horário, origem e resultado dos deploys. Isso torna a republicação rastreável e permite recuperar conteúdo anterior sem criar outro Site.

Status terminal é a prova

O agente recebe um identificador de deploy e consulta deploy_status. Os estados terminais são success, failed e worker_upload_failed.

Somente success autoriza a resposta “está no ar”. Em falhas, o agente relata o erro, corrige os arquivos quando possível e publica outra Version.

O que o usuário deve receber

Uma resposta final útil contém:

  • Site e slug usados;
  • resumo da mudança;
  • status terminal;
  • URL pública;
  • verificação realizada;
  • qualquer aviso de substituição de uma Version mais nova.

Esse é o modelo descrito em Publicação. O setup de cada cliente fica separado em Configuração; depois da conexão, o fluxo é o mesmo.