Sandboxes SDK

const sandbox = await rt.sandbox.create({
  name: 'dev-env',
  template: 'base-ubuntu',
  tags: ['docs'],
  resources: { vcpus: 1, memory: '1GB', disk: '10GB' },
  env: { NODE_ENV: 'development' },
  idleTimeout: 600,
  mounts: [{ workspaceId: '9b84ef42-9c3a-4930-9d4c-45c7f5c22d8e', path: '/workspace' }],
});

await sandbox.waitForReady();

const all = await rt.sandbox.list();
const running = await rt.sandbox.list({ status: 'running', limit: 20 });

const page = await rt.sandbox.listPage({
  status: 'running',
  limit: 20,
});

const sandbox = rt.sandbox.get('sandbox-abc123');

const result = await sandbox.exec('npm test', {
  cwd: '/workspace',
  timeout: 120000,
  env: { CI: 'true' },
});

console.log(result.exitCode);
console.log(result.stdout);
console.log(result.stderr);

await sandbox.pause();
await sandbox.resume();
await sandbox.destroy();

await rt.sandbox.destroy('sandbox-abc123');

// Capability-protected URL for a port (wakes a paused sandbox).
const { url } = await rt.sandbox.getUrl('sandbox-abc123', 3000);

// Connection details for SSH / the browser desktop.
const ssh = await rt.sandbox.ssh('sandbox-abc123');
const vnc = await rt.sandbox.vnc('sandbox-abc123');     // desktop templates; URL is normalized

// Logs, point-in-time metrics, activity, and metadata updates.
const { entries } = await rt.sandbox.logs('sandbox-abc123', { tail: 100 });
const metrics = await rt.sandbox.stats('sandbox-abc123');
const { events } = await rt.sandbox.activity('sandbox-abc123', { limit: 50 });
await rt.sandbox.update('sandbox-abc123', { name: 'renamed', tags: ['ci'] });

await sandbox.waitForReady(120000);

const offStatus = sandbox.on('status', (state) => {
  console.log(state.status, state.sshReady, state.vncReady);
});

const offMetrics = sandbox.on('metrics', (metrics) => {
  console.log(metrics.cpuPercent, metrics.memUsedPercent);
});

offStatus();
offMetrics();
await sandbox.close();