Saúde do FTP: data_dir, arquivos, hashes cadastrados e identidade deste agente.

Admin: cadastra um access_hash. Exige senha do admin. Clientes usam o hash gerado em put/get.

Admin: revoga um hash cadastrado. put/get com ele passam a falhar.

Lista hashes. Com senha admin lista todos; sem ela, só os criados por este agente.

Envia arquivo. Exige access_hash cadastrado (ftp_register). Grava SHA-256, verifica disco e extrai metadados.

Baixa arquivo. Exige o mesmo access_hash cadastrado usado no put. Recalcula SHA-256.

Lista o diretório deste access_hash. Cada arquivo vem com hash de conteúdo e metadados.

Metadados de um path neste hash cadastrado, sem o conteúdo.

Só metadados extraídos. Exige access_hash. Por path ou pelo hash do conteúdo.

Cria diretório neste hash cadastrado.

Remove arquivo ou diretório neste hash. Pasta não vazia exige recursive=true.

Move/renomeia path dentro do mesmo access_hash.

Copia arquivo dentro do mesmo access_hash.

Recalcula SHA-256 no disco. Exige access_hash. Disco alterado → tampered.

Busca arquivos deste access_hash por path, hash de conteúdo ou metadados.

Guarda um blob imutável e devolve o hash SHA-256. Mesmo conteúdo = mesmo hash.

Lê um snapshot imutável pelo hash (ou prefixo único). Não segue o ponteiro do documento.

Cria um documento editável. O doc_id padrão é o hash do conteúdo inicial — compartilhe esse id.

Lê a versão atual de um documento (doc_id) ou um blob (hash). Aceita share_token.

Metadados do documento sem o conteúdo (hash atual, versão, lock, dono).

Atualiza com compare-and-swap. Falha com code=conflict se expected_hash não for o atual.

Adquire lock de edição e devolve content + hash + lock_token. Outro agente recebe code=locked.

Grava a edição do checkout. Exige lock_token e expected_hash. Libera o lock salvo keep_lock=true.

Libera o lock sem gravar (checkout abandonado).

Compartilha para edição. Com to_agent_id concede grant; sem ele gera share_token para outro agente.

Revoga grant ou share_token. Sem os dois, revoga todos os tokens do documento.

Resgata um share_token e grava grant permanente para este agente.

Lista documentos visíveis para este agente. query filtra título, tags, hash e preview.

Busca documentos por título, tags, hash ou trecho do preview.

Cadeia de versões (hash ← parent_hash) com o agente que commitou cada uma.

Cria um documento novo a partir de um doc_id ou de um hash imutável.