Connect to a Sandbox

import sys
from boxrouter import BoxRouter

with BoxRouter() as client:
    with client.sandboxes.create(requirements=["terminal"]) as box:
        terminal = box.open_terminal()
        terminal.write(b"printf 'hello\\n'; exit 3\n")
        for chunk in terminal.output():
            sys.stdout.buffer.write(chunk)
        sys.stdout.buffer.flush()
        print("exit code:", terminal.exit_code)

import { BoxRouter } from '@boxrouter/sdk';

await using client = new BoxRouter();
await using box = await client.sandboxes.create({ requirements: ['terminal'] });
const terminal = await box.openTerminal();
await terminal.write(new TextEncoder().encode("printf 'hello\\n'; exit 3\n"));
for await (const chunk of terminal.output()) process.stdout.write(chunk);
console.log('exit code:', terminal.exitCode);

(
  set -euo pipefail
  ID=$(boxrouter create --require terminal)
  trap 'boxrouter destroy "$ID"' EXIT
  boxrouter terminal "$ID"
)

import sys
from boxrouter import BoxRouter

sandbox_id = "<SANDBOX_ID>"
terminal_id = "<TERMINAL_ID>"
last_event_id = "<LAST_EVENT_ID>"

with BoxRouter() as client:
    terminal = client.sandboxes.open_terminal(sandbox_id, terminal_id=terminal_id)
    try:
        for chunk in terminal.output(last_event_id=last_event_id):
            sys.stdout.buffer.write(chunk)
    finally:
        terminal.close()

import { BoxRouter } from '@boxrouter/sdk';

const sandboxId = '<SANDBOX_ID>';
const terminalId = '<TERMINAL_ID>';
const lastEventId = '<LAST_EVENT_ID>';
await using client = new BoxRouter();
const terminal = await client.sandboxes.openTerminal(sandboxId, { terminalId });
try {
  for await (const chunk of terminal.output({ lastEventId })) process.stdout.write(chunk);
} finally {
  terminal.close();
}

boxrouter terminal "$SANDBOX_ID" --terminal-id "$TERMINAL_ID" --last-event-id "$LAST_EVENT_ID"

from boxrouter import BoxRouter

with BoxRouter() as client:
    with client.sandboxes.create(
        requirements={"previews": {"access": "public", "ports": [3000]}},
    ) as box:
        box.processes.start("python3 -m http.server 3000", wait_for_port=3000)
        print(box.previews.open(3000).url)
        input("Press Enter to destroy the sandbox: ")

import { createInterface } from 'node:readline/promises';
import { BoxRouter } from '@boxrouter/sdk';

await using client = new BoxRouter();
await using box = await client.sandboxes.create({ requirements: { previews: { access: 'public', ports: [3000] } } });
await box.processes.start('python3 -m http.server 3000', { wait_for_port: 3000 });
console.log((await box.previews.open(3000)).url);
const prompt = createInterface({ input: process.stdin, output: process.stdout });
try {
  await prompt.question('Press Enter to destroy the sandbox: ');
} finally {
  prompt.close();
}

(
  set -euo pipefail
  ID=$(boxrouter create --requirements '{"previews":{"access":"public","ports":[3000]}}')
  trap 'boxrouter destroy "$ID"' EXIT
  boxrouter process start "$ID" 'python3 -m http.server 3000' --wait-for-port 3000 >/dev/null
  boxrouter preview "$ID" 3000
  read -r -p "Press Enter to destroy the sandbox: "
)

(
  set -euo pipefail
  API="${BOXROUTER_BASE_URL:-https://api.boxrouter.ai/api/v1}"
  AUTH="Authorization: Bearer $BOXROUTER_API_KEY"
  id=$(curl -sSf -X POST "$API/sandboxes" -H "$AUTH" -H 'Content-Type: application/json' \
    -d '{"requirements":{"previews":{"access":"public","ports":[3000]}}}' | jq -er .id)
  trap 'curl -sSf -X DELETE "$API/sandboxes/$id" -H "$AUTH" >/dev/null' EXIT
  curl -sSf -X POST "$API/sandboxes/$id/processes" -H "$AUTH" -H 'Content-Type: application/json' \
    -d '{"command": "python3 -m http.server 3000", "wait_for_port": 3000}' >/dev/null
  curl -sSf -X POST "$API/sandboxes/$id/previews" -H "$AUTH" \
    -H 'Content-Type: application/json' -d '{"port":3000}' | jq -er '.url | strings | select(startswith("https://"))'
  read -r -p 'Press Enter to destroy the sandbox: '
)