Agent Sandbox SDK

​

Install

npm install @mogenius/sandbox

​

Authenticate

• MOGENIUS_API_KEY — an API key for your organization.
• MOGENIUS_CLUSTER_ID — the cluster the sandboxes run on.

​

Quickstart

import { Mogenius } from '@mogenius/sandbox';

const mogenius = new Mogenius();

// Provision a sandbox (from the template's warm pool when available)
const sandbox = await mogenius.create();

// Run a command inside it
const result = await sandbox.process.executeCommand('python3 --version');
console.log(result.exitCode, result.result);

// Tear it down
await mogenius.delete(sandbox);

​

Surface

• Lifecycle — mogenius.create() provisions a sandbox; mogenius.delete(sandbox) tears it down.
• Process — sandbox.process.executeCommand(command) runs shell commands and returns the exit code and output.
• Code — sandbox.codeRun() executes code directly.
• Filesystem — sandbox.fs reads, writes, and lists files in the sandbox.
• Sessions — persistent shell sessions for long-running or multi-step work.
• Tunnels — reach a port inside the sandbox from your client.
• Errors — a typed error hierarchy keyed by HTTP status, so callers can branch on failure cleanly.

​

REST API