Skip to main content

Sandbox

O sandbox é um ambiente de execução na cloud que está sempre disponível. Mesmo sem um daemon local conectado, o bot pode executar código.

Linguagens suportadas

  • JavaScript (Node.js)
  • Python
  • Bash

Como funciona

Quando você pede pro bot executar algo:
  1. Se tem um daemon local conectado → executa no seu terminal
  2. Se não tem → executa automaticamente no sandbox cloud
Você pode forçar o uso do sandbox especificando o ambiente:
Execute isso no sandbox: console.log("hello")

Ambientes persistentes

Cada usuário pode criar até 3 ambientes sandbox nomeados. Arquivos e pacotes instalados persistem entre sessões via R2 mount.
AçãoDescrição
listVer todos os ambientes
createCriar novo ambiente (nome com letras, números, hífens)
archiveArquivar ambiente (soft delete)
infoDetalhes de um ambiente
O ambiente default é criado automaticamente e não pode ser arquivado.

Infraestrutura

O sandbox roda em Cloudflare Containers (@cloudflare/sandbox) com containers Docker isolados por sessão. Cada execução tem timeout configurável. Ambientes persistentes usam R2 para montar o storage do usuário.