Servidor por pacote, rodando junto do agente

Camada funcional

Nem toda ferramenta tem endereço na internet. Algumas são programas publicados num registro de pacotes, e algumas precisam enxergar os arquivos com que o agente está trabalhando. Para essas, o VolundOS não conecta a lugar nenhum: ele executa o pacote dentro da máquina do agente, durante a execução.

O que identifica um servidor desses é o par registro mais pacote, único por agente. Ele se autentica com variáveis guardadas cifradas, ou com um login interativo cujo estado fica salvo. E o teste de conexão acontece numa máquina descartável, criada só para isso.

Dois registros são aceitos: o do JavaScript e o do Python. Você escolhe qual, e informa o pacote — o comando em si nunca vem do que foi digitado. O nome do pacote, os argumentos e os nomes das variáveis passam por validação antes de qualquer coisa rodar.

A versão precisa ser exata

Por que resolver em vez de simplesmente exigir a versão exata de você: a documentação da maioria dos fornecedores manda instalar a versão mais nova, e recusar isso daria erro em quem colou exatamente o que a documentação mandou.

Por que recusar quando não dá para resolver: um cadastro que aponta para "a mais nova" nunca é revisitado. Ele passaria a instalar código novo a cada partida, para sempre, sem ninguém aprovar. E o programa recebe as credenciais daquele servidor, então uma publicação comprometida do fornecedor chega direto nelas. Falhar custa um clique quando o registro está lento; o contrário custava uma porta aberta permanente.

O que a versão exata garante — e o que não garante: os registros não deixam republicar uma versão que já saiu, e o download confere a integridade do pacote; na prática, a versão amarra o programa. O que não existe é uma impressão do pacote guardada do nosso lado — ela exigiria trocar o modo de execução inteiro, e está registrada como item em aberto.

O risco que esse cadastro representa

Este é o parágrafo mais importante do módulo.

Na execução real, quem abre o processo do servidor não é o VolundOS: é o próprio programa do agente. E ele passa adiante o ambiente em que está rodando, somado às variáveis daquele servidor. Ou seja: um servidor por pacote enxerga o ambiente da execução — inclusive o que o cofre injetou ali. Isso não é uma opção que dê para desligar: é como esse tipo de conexão funciona.

Em termos de decisão: cadastrar um pacote é confiar naquele pacote com o ambiente da execução, no mesmo nível de confiança que se tem num agente com acesso irrestrito à própria máquina. Por isso cadastrar pela conversa exige, além da permissão de mexer em servidores, a permissão específica de adicionar um.

Nos momentos em que quem executa o programa é o próprio VolundOS — o teste de conexão e o preaquecimento —, o ambiente é mínimo: só o que aquele servidor declarou precisar.

A primeira partida demora

Baixar o pacote e as dependências dele acontece durante a conexão, e o agente só termina de subir depois que todos os servidores responderam. Duas coisas amortecem isso: o download começa cedo, em paralelo com o resto do preparo da máquina, e o tempo de espera é mais generoso quando há pelo menos um servidor desse tipo.

Quando dá errado

O erro do teste de conexão devolve o fim da mensagem do programa — pacote que não existe, variável que faltou, saída inesperada — com as credenciais borradas. Muitos programas ecoam a própria configuração na mensagem de erro, e ali a configuração são as chaves. O texto integral fica no registro de execução, que é onde diagnóstico pertence.