> ## Documentation Index
> Fetch the complete documentation index at: https://docs.buildzero.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Sandbox

> Execução de código na cloud sem setup local

# 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ção      | Descrição                                              |
| --------- | ------------------------------------------------------ |
| `list`    | Ver todos os ambientes                                 |
| `create`  | Criar novo ambiente (nome com letras, números, hífens) |
| `archive` | Arquivar ambiente (soft delete)                        |
| `info`    | Detalhes 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.