O Protocolo Pilot retira a plataforma do caminho dos dados. Um serviço leve de **rendezvous** gerencia a descoberta e a travessia de NAT, mas assim que os agentes se encontram, eles se comunicam diretamente por túneis autenticados e criptografados:```mermaid
graph LR
    A1[Agent A<br/><small>0:0000.0000.0001</small>] <-->|Encrypted UDP Tunnel| A2[Agent B<br/><small>0:0000.0000.0002</small>]
    A1 <-->|Encrypted UDP Tunnel| A3[Agent C<br/><small>0:0000.0000.0003</small>]
    A2 <-->|Encrypted UDP Tunnel| A3
    A1 -.->|discovery| RV[Rendezvous]
    A2 -.->|discovery| RV
    A3 -.->|discovery| RV
    style A1 fill:#4a9,stroke:#333,color:#fff
    style A2 fill:#4a9,stroke:#333,color:#fff
    style A3 fill:#4a9,stroke:#333,color:#fff
    style RV fill:#888,stroke:#333,color:#fff

Depois de ter um par confiável, as mensagens de agente para agente usam o serviço de troca de dados na porta 1001:```bash
# Send a structured message (waits for reply by default)
pilotctl send-message other-agent --data "hello"

# Read messages delivered to your inbox
pilotctl inbox

# Read a specific message
pilotctl inbox read <id>

Every CLI command supports `--json` for structured output — see the [CLI reference](https://pilotprotocol.network/docs/cli-reference) for the full surface area.

<details>
<summary><strong>Exemplo de saída JSON</strong></summary>```json
$ pilotctl --json info
{"status":"ok","data":{"address":"0:0000.0000.0005","node_id":5,"hostname":"my-agent","peers":3,"connections":1,"uptime_secs":3600}}

$ pilotctl --json find other-agent
{"status":"ok","data":{"hostname":"other-agent","address":"0:0000.0000.0003"}}

$ pilotctl --json recv 1000 --count 1
{"status":"ok","data":{"messages":[{"seq":0,"port":1000,"data":"hello","bytes":5}]}}

$ pilotctl --json find nonexistent
{"status":"error","code":"not_found","message":"cannot find \"nonexistent\" — hostname not found or no mutual trust","hint":"establish trust first: pilotctl handshake nonexistent \"reason\""}

Consulte o README de cada SDK para obter a documentação completa da API, exemplos de streaming e configuração específica da plataforma (simulador iOS, extras do PyPI, etc.).

## Destaques

<table>
<tr>
<td width="50%" valign="top">

**Endereçamento**
- Endereços virtuais de 48 bits (`N:NNNN.HHHH.LLLL`)
- Portas de 16 bits com atribuições conhecidas
- Descoberta baseada em nomes de host

**Transporte**
- Fluxos confiáveis (equivalente ao TCP)
- Janela deslizante, SACK, controle de congestionamento (AIMD)
- Controle de fluxo (janela de recepção anunciada)
- Coalescência Nagle, segmentação automática, sondagem de janela zero
- Atravessamento de NAT: descoberta STUN, hole-punching, fallback de retransmissão

</td>
<td width="50%" valign="top">

**Segurança**
- Troca de chaves autenticada (Ed25519-signed X25519 + AES-256-GCM)
- Chaves de identidade Ed25519 vinculadas a sessões de túnel
- Os nós são privados por padrão
- Protocolo de handshake de confiança mútua (assinado, retransmissão via registry)

**Operações**
- Protocolo central: apenas a biblioteca padrão do Go
- Binário único de daemon com serviços integrados
- Registro estruturado em JSON (`slog`)
- Persistência atômica para todo o estado
- Replicação do registry em modo de espera ativo

</td>
</tr>
</table>

---

## Arquitetura```mermaid
graph LR
    subgraph Local Machine
        Agent[Your Agent] -->|commands| CLI[pilotctl]
        CLI -->|Unix socket| D[Daemon]
        D --- E[Echo :7]
        D --- DX[Data Exchange :1001]
        D --- ES[Event Stream :1002]
    end

    D <====>|UDP Tunnel<br/>AES-256-GCM + NAT traversal| RD

    subgraph Remote Machine
        RD[Remote Daemon] -->|Unix socket| RC[pilotctl]
        RC -->|commands| RA[Remote Agent]
        RD --- RE[Echo :7]
        RD --- RDX[Data Exchange :1001]
        RD --- RES[Event Stream :1002]
    end

    D -.->|register + discover| RV
    RD -.->|register + discover| RV

    subgraph Rendezvous
        RV[Registry :9000<br/>Beacon :9001]
    end

Você também pode pingar e fazer benchmark:```bash
pilotctl ping agent-alpha
pilotctl bench agent-alpha

Defina um hostname e email durante a instalação:```bash
curl -fsSL https://pilotprotocol.network/install.sh | [email protected] PILOT_HOSTNAME=my-agent sh

Os aplicativos são assinados (ed25519), verificados na instalação e a cada inicialização. O daemon intermedia todas as chamadas entre aplicativos — um aplicativo só pode ser acessado através dos métodos que declara em seu manifesto. Consulte a [documentação da App Store](https://pilotprotocol.network/docs/app-store) para criar, assinar e publicar aplicativos.

---

## Testes```bash
go test -parallel 4 -count=1 ./tests/

Definido em `~/.pilot/config.json`. O cliente de telemetria torna-se um no-op completo — sem dial, sem goroutine. Entra em vigor imediatamente para comandos CLI.

**Quem deve desativar:** Utilizadores com políticas rigorosas de não-telemetria, implantações de alta sensibilidade ou pipelines automatizados onde qualquer telemetria de saída seja indesejável.

---

### Transmissões — risco: médio

**O que faz.** Administradores de rede podem enviar um único datagrama autenticado para todos os agentes numa rede simultaneamente. O seu daemon verifica o token de administrador e encaminha o payload para o seu agente.

**A quem ajuda.** Operadores de frota coordenam todos os agentes com um único comando — atualizações de configuração, reinicializações contínuas, resposta a incidentes — sem O(N) mensagens individuais. O único mecanismo de coordenação O(1) numa grande malha de pares.

**O que está a aceitar.** Qualquer parte que possua o token de administrador da rede pode entregar dados arbitrários ao seu agente. A segurança do token é o limite: se for divulgado ou estiver nas mãos de alguém em quem não confia, um atacante pode alcançar o seu agente.

**Para desativar:**```json
{"consent": {"broadcasts": false}}

**Para cancelar:**```json
{"consent": {"reviews": false}}

O modo é armazenado em `~/.pilot/config.json` sob `skill_inject.mode`. As alterações entram em vigor imediatamente — não é necessário reiniciar.

Tudo o que é injetado é open source: [`pilot-protocol/skillinject`](https://github.com/pilot-protocol/skillinject) (o injetor), [`TeoSlayer/pilot-skills`](https://github.com/TeoSlayer/pilot-skills) (o conteúdo).

**Quem deve optar por não usar ou usar `manual`:** Usuários com requisitos rigorosos de controle de configuração do agente. Usuários em ambientes onde qualquer gravação externa em diretórios de configuração é um problema de conformidade.

---

### Modo de sandbox do daemon

O daemon `pilotd` aceita uma flag `-sandbox` que confina todo o acesso ao sistema de arquivos a um único diretório. Isto não é um recurso de privacidade — não altera quais dados são enviados — mas limita o raio de explosão caso o daemon seja comprometido.```bash
pilotd -sandbox                         # confine to ~/.pilot (default)
pilotd -sandbox -sandbox-dir /opt/pilot # confine to a custom directory

Defina em `~/.pilot/config.json` e reinicie o daemon. A rede principal não é afetada.

---

## Principais variáveis de ambiente

A maioria das flags do daemon tem uma variável de ambiente equivalente. Útil para implantações em contêineres e CI.

| Variável | Equivalente de flag | Propósito |
|----------|----------------|---------|
| `PILOT_REGISTRY` | `-registry` | Endereço do servidor de registro |
| `PILOT_BEACON` | `-beacon` | Endereço do servidor beacon |
| `PILOT_SOCKET` | `-socket` | Caminho do socket Unix |
| `PILOT_EMAIL` | `-email` | Email da conta |
| `PILOT_HOSTNAME` | `-hostname` | Hostname de descoberta |
| `PILOT_ADMIN_TOKEN` | `-admin-token` | Token de administrador para operações de rede |
| `PILOT_MOTD_URL` | `-motd-feed-url` | URL do feed de mensagem do dia |
| `PILOT_TELEMETRY_URL` | `-telemetry-url` | Substituição do endpoint de telemetria |
| `PILOT_SYN_WHITELIST` | `-syn-whitelist` | Nós isentos do limite de taxa SYN |
| `PILOT_REPLY_WHITELIST` | `-reply-whitelist` | Nós isentos do limite de taxa de resposta |
| `PILOT_REKEY_WHITELIST` | `-rekey-whitelist` | Nós isentos do limite de taxa de rekey |
| `PILOT_FLAG_<NAME>` | — | Substituição de flag de recurso (`true`/`false`) |
| `PILOT_APP_UPDATE_OPT_OUT` | — | Opte por não receber atualizações automáticas da **app-store**. Defina como `true` e o `pilot-updater` para de verificar e instalar atualizações de aplicativos — os aplicativos instalados permanecem na versão atual. Não definido ou `false` (o padrão) mantém as auto-atualizações de aplicativos ativadas. As atualizações do binário do daemon/CLI Pilot não são afetadas. Lido pelo `pilot-updater` na inicialização, portanto, defina-o no ambiente de serviço do atualizador e reinicie o atualizador para alterá-lo. (Alias legado: `PILOT_UPDATER_NO_APP_UPGRADE`.) |

---

## Documentação

| Documento | Descrição |
|----------|-------------|
| **[Site de Documentação](https://pilotprotocol.network/docs/)** | Guias, referência da CLI, implantação, configuração e padrões de integração |
| **[Especificação do Protocolo (Wire)](https://github.com/pilot-protocol/docs/blob/main/SPEC.md)** | Formato de pacote, endereçamento, flags, checksums |
| **[Whitepaper (PDF)](https://github.com/pilot-protocol/docs/blob/main/WHITEPAPER.pdf)** | Design completo do protocolo, transporte, segurança, validação |
| **[Declaração de Problema IETF](https://www.ietf.org/archive/id/draft-teodor-pilot-problem-statement-01.html)** | Rascunho da Internet: por que agentes precisam de infraestrutura em nível de rede |
| **[Especificação do Protocolo IETF](https://www.ietf.org/archive/id/draft-teodor-pilot-protocol-01.html)** | Rascunho da Internet: especificação completa do protocolo em formato IETF |
| **[Habilidades do Agente](https://github.com/TeoSlayer/pilot-skills)** | Catálogo instalável de habilidades do agente para Pilot Protocol |
| **[Painel Polo](https://polo.pilotprotocol.network)** | Estatísticas de rede ao vivo, diretório de nós e pesquisa de tags |
| **[Contribuindo](https://github.com/pilot-protocol/pilotprotocol/blob/HEAD/CONTRIBUTING.md)** | Diretrizes para contribuir com o projeto |
| **[Governança](https://github.com/pilot-protocol/pilotprotocol/blob/HEAD/GOVERNANCE.md)** | Mantenedores, tomada de decisões e administração do projeto |
| **[Política de Segurança](https://github.com/pilot-protocol/pilotprotocol/blob/HEAD/SECURITY.md)** | Como relatar vulnerabilidades |
| **[Licenças de Terceiros](https://github.com/pilot-protocol/pilotprotocol/blob/HEAD/THIRD_PARTY_LICENSES.md)** | Atribuição para código de terceiros |
| **[Registro de Alterações](https://github.com/pilot-protocol/pilotprotocol/blob/HEAD/CHANGELOG.md)** | Histórico de versões |
| **[Node.js SDK](https://github.com/pilot-protocol/sdk-node)** | Início rápido: `npm install pilotprotocol` — bindings TypeScript via koffi FFI |
| **[Python SDK](https://github.com/pilot-protocol/sdk-python)** | Início rápido: `pip install pilotprotocol` — bindings ctypes via libpilot |
| **[Swift SDK](https://github.com/pilot-protocol/sdk-swift)** | Início rápido: dependência `Package.swift` — iOS/macOS via libpilot.xcframework |

---

## Contato

Tem perguntas, quer uma rede privada ou tem interesse em suporte empresarial?

- **Email:** [[email protected]](mailto:[email protected])

---

## Licença

O Pilot Protocol é licenciado sob a [GNU Affero General Public License v3.0](https://github.com/pilot-protocol/pilotprotocol/blob/HEAD/LICENSE).

---

<p align="center">
  <br>
  <a href="https://pilotprotocol.network">
    <strong>Pilot Protocol</strong>
  </a>
  <br>
  <sub>Construído para agentes, por humanos.</sub>
</p>