API Reference managoat_sandbox v#0.2.0

Copy Markdown View Source

Modules

The sandbox backend contract: one behaviour, one facade, one error taxonomy.

A provider-tagged handle to a running (or attached) streaming command.

Per-adapter settings, read from this library's own otp_app.

The executable form of the Managoat.Sandbox contract: a shared suite every adapter must pass.

The Daytona adapter: Managoat.Sandbox implemented against daytona.io (or a self-hosted Daytona via DAYTONA_API_URL).

Daytona control-plane client (app.daytona.io/api, or a self-hosted instance via DAYTONA_API_URL).

Normalizes Daytona error shapes into the Managoat.Sandbox taxonomy — the same mapping discipline as the other adapters, tagged :daytona.

Streams a Daytona session command's journaled log into the Managoat.Sandbox owner-frame contract — by polling the plain HTTP log endpoint, deliberately not the websocket.

Daytona toolbox client — the in-sandbox REST API, proxied per sandbox at its toolboxProxyUrl (same Bearer auth as the control plane).

The E2B adapter: Managoat.Sandbox implemented against e2b.dev.

E2B control-plane client (api.e2b.app): sandbox lifecycle, listing, pause/resume, TTL and network policy.

One process per streaming E2B command: owns the Connect stream, translates envd events into the Managoat.Sandbox owner-frame contract, and heartbeats the sandbox TTL while the command lives.

E2B data-plane client: "envd", the daemon inside every sandbox, reachable at https://49983-{sandboxId}.{domain}.

Normalizes E2B error shapes into the Managoat.Sandbox taxonomy — the same mapping discipline as the Sprites adapter's, with :e2b as the escape-hatch tag.

A real, in-memory Managoat.Sandbox adapter.

A provider-tagged reference to a sandbox.

An intent-level, default-deny egress policy.

Bounded exponential backoff for idempotent external calls.

A normalized record of a detachable session living inside a sandbox.

The Sprites adapter: Managoat.Sandbox implemented against sprites.dev via the sprites-ex SDK.

SDK client construction and account listing for the Sprites adapter.

Normalizes sprites-ex error shapes into the Managoat.Sandbox taxonomy.