Eve

import { asciiBox } from "@asciidev/eve-box";

async function main() {
  const backend = asciiBox({
    apiKey: process.env.BOAT_API_KEY!,
    name: "eve-hello",
    ttlSeconds: 600,
  });

  // Create a session (this provisions a sandbox and waits until it is ready).
  const handle = await backend.create({
    templateKey: null,
    sessionKey: "hello-session",
    runtimeContext: { appRoot: process.cwd() },
  });
  const session = await handle.useSessionFn({ networkPolicy: "allow-all" });

  // Write a file, run a command against it, and read the result back.
  await session.writeTextFile({ path: "notes/hello.txt", content: "hello from Boat\n" });
  const result = await session.run({ command: "cat notes/hello.txt && uname -a" });
  console.log("exit:", result.exitCode);
  console.log(result.stdout);

  // Paths resolve under /workspace, matching Eve's sandbox contract.
  console.log(session.resolvePath("notes/hello.txt")); // -> /workspace/notes/hello.txt
}

main().catch((error) => {
  console.error(error);
  process.exitCode = 1;
});

import { defineSandbox } from "eve/sandbox";
import { asciiBox } from "@asciidev/eve-box";

export default defineSandbox({
  backend: asciiBox({
    apiKey: process.env.BOAT_API_KEY!,
    noEnv: true,
    // Scoped secrets: the only env this sandbox gets:
    env: { MY_APP_TOKEN: process.env.MY_APP_TOKEN! },
  }),
  async onSession({ use }) {
    const sandbox = await use();
    // Seed files and run setup with the session API. These wrap Boat's file
    // and command APIs, so you don't need `boat scp` or `boat ssh`.
    await sandbox.writeTextFile({ path: "config/app.json", content: JSON.stringify({ mode: "prod" }) });
    await sandbox.run({ command: "git clone https://github.com/acme/public-repo . && npm ci" });
  },
});