Use OpenAI Agents SDK with sandboxes

npm init # if new project
npm install @openai/agents-extensions @blaxel/core

import { run } from "@openai/agents";
import { Manifest, SandboxAgent } from "@openai/agents/sandbox";
import { BlaxelSandboxClient } from "@openai/agents-extensions/sandbox/blaxel";

async function main() {
  const agent = new SandboxAgent({
    name: "Sandboxed agent",
    model: "gpt-5.4",
    instructions:
      "You have access to a sandbox environment. You can execute commands, manage files, and inspect processes inside the sandbox.",
    modelSettings: { toolChoice: "auto" },
    defaultManifest: new Manifest({ root: "/blaxel" }),
  });

  const client = new BlaxelSandboxClient();

  const result = await run(
    agent,
    "Install a complete Go development environment. Once done, return the installed Go version number and Go environment variables.",
    {
      maxTurns: 50,
      sandbox: {
        client,
        options: {
          name: "agent-sandbox-01",
          image: "blaxel/base-image",
          region: "us-pdx-1",
          memory: 4096,
        },
      },
    }
  );

  console.log(result.finalOutput);
}

await main().catch(console.error);

import { run } from "@openai/agents";
import { SandboxAgent } from "@openai/agents/sandbox";
import { BlaxelSandboxClient } from "@openai/agents-extensions/sandbox/blaxel";
import { writeFileSync } from "fs";

async function main() {
  const client = new BlaxelSandboxClient();
  const session = await client.create({
    options: {
      name: "agent-sandbox-02",
      image: "blaxel/py-app",
      region: "us-pdx-1",
      memory: 4096,
    },
  });

  const agent = new SandboxAgent({
    name: "Data analyst",
    model: "gpt-5.4",
    instructions:
      "You are a data analyst. You have access to a sandbox environment. You can execute commands, manage files, and inspect processes inside the sandbox.",
  });

  const stream = await run(
    agent,
    "Obtain sample telemetry data using the API https://api.datamock.dev/v1/iot-telemetry?quantity=10&deviceType=wearable_fitness_tracker&exclude=deviceId,ipAddress,macAddress,signalStrength,networkType,location,status,batteryLevel,lastSync,firmwareVersion,alerts." +
      "Analyze the received data and create a chart showing memory and CPU usage. Save it as /workspace/chart.png. " +
      "Install any packages you need.",
    {
      stream: true,
      maxTurns: 50,
      sandbox: { session },
    }
  );

  process.stdout.write("assistant> ");
  stream.toTextStream({ compatibleWithNodeStreams: true }).pipe(process.stdout);
  await stream.completed;
  process.stdout.write("\n");

  const chartData = await session.readFile({ path: "/workspace/chart.png" });
  writeFileSync("chart.png", chartData);
  console.log("Saved chart to host as chart.png");

  await session.close();
  await session.shutdown();
}

await main().catch(console.error);

import { run } from "@openai/agents";
import { Manifest, SandboxAgent } from "@openai/agents/sandbox";
import { urlForExposedPort } from "@openai/agents-core/sandbox";
import { BlaxelSandboxClient } from "@openai/agents-extensions/sandbox/blaxel";

async function main() {
  const task = process.argv.slice(2).join(" ").trim();
  if (!task) {
    console.log("Usage: node index.ts <task>");
    process.exit(1);
  }

  const client = new BlaxelSandboxClient();
  const session = await client.create({
    manifest: new Manifest({ root: "/blaxel" }),
    options: {
      name: "agent-sandbox-03",
      image: "blaxel/nextjs:latest",
      region: "us-pdx-1",
      memory: 4096,
      exposedPortPublic: true,
      pauseOnExit: true,
      ttl: "30m",
    },
  });

  const agent = new SandboxAgent({
    name: "Next.js code generation agent",
    model: "gpt-5.4",
    instructions:
      "You are a Next.js expert with shell access to a sandbox. You can execute commands, manage files, and start servers. The sandbox includes a skeleton Next.js app in /blaxel.",
    modelSettings: { toolChoice: "auto" },
  });

  try {
    const stream = await run(agent, task, {
      stream: true,
      maxTurns: 50,
      sandbox: { session },
    });

    process.stdout.write("assistant> ");
    stream.toTextStream({ compatibleWithNodeStreams: true }).pipe(process.stdout);
    await stream.completed;
    process.stdout.write("\n");

    const endpoint = await session.resolveExposedPort(3000);
    const previewUrl = urlForExposedPort(endpoint, "http");
    console.log(`Preview URL: ${previewUrl}`);
  } finally {
    await session.close();
    await session.shutdown();
  }
}

await main().catch(console.error);

# Node.js
node index.ts "My cat Kitty does amazing things. Create a website about her."

# Bun
bun index.ts "My cat Kitty does amazing things. Create a website about her."