Agent tools

import asyncio
from boxlite import SimpleBox, CodeBox

async def main():
    # ---- 1. Run an arbitrary shell command (the most general agent tool) ----
    try:
        # auto_remove=True is the wrapper-layer default: cleaned up on exiting async with
        async with SimpleBox(image="alpine:latest") as box:
            # exec takes (command, *args); returns ExecResult
            result = await box.exec("echo", "hello from an agent")

            # Important: a non-zero exit code does NOT raise; you must check exit_code
            if result.exit_code != 0:
                print("command failed:", result.stderr)
            else:
                print("stdout:", result.stdout.strip())
    except RuntimeError as e:
        # Image pull failure / no virtualization raises a standard RuntimeError (not BoxliteError)
        print("startup or pull failed:", e)

    # ---- 2. Run agent-generated Python code (CodeBox defaults to python:slim) ----
    try:
        async with CodeBox() as code_box:
            # run() executes a code string and returns stdout (str)
            generated_code = "print(sum(range(1, 11)))"
            output = await code_box.run(generated_code)
            print("code output:", output.strip())
    except RuntimeError as e:
        print("CodeBox failed:", e)

asyncio.run(main())

// The package name is @boxlite-ai/boxlite (not 'boxlite', not '@boxlite/sdk')
import { SimpleBox, CodeBox } from "@boxlite-ai/boxlite";

async function main(): Promise<void> {
  // ---- 1. Run an arbitrary shell command ----
  try {
    // await using: cleaned up automatically at end of scope per autoRemove (default true)
    await using box = new SimpleBox({ image: "alpine:latest" });

    const result = await box.exec("echo", "hello from an agent");

    if (result.exitCode !== 0) {
      console.error("command failed:", result.stderr);
    } else {
      console.log("stdout:", result.stdout.trim());
    }
  } catch (e) {
    console.error("failed:", e);
  }

  // ---- 2. Run agent-generated code (CodeBox image defaults to python:slim) ----
  try {
    await using codeBox = new CodeBox();
    const output = await codeBox.run("print(sum(range(1, 11)))");
    console.log("code output:", output.trim());
  } catch (e) {
    console.error("CodeBox failed:", e);
  }
}

main();

result = await box.exec("false")  # exit_code = 1
if result.exit_code != 0:
    ...