Miosa.Sandboxes (Miosa v1.0.0)

Sandboxes — a thin helper over Miosa.Computers that defaults template_type to "miosa-sandbox" (ephemeral code-exec rootfs, no desktop).

Mirrors the one-resource product model used by E2B and Daytona: the computer is the single resource type, and template_type selects its flavour. A sandbox is just a computer with the lightweight template; every other module (Miosa.Computer, Miosa.Exec, Miosa.Files, Miosa.Desktop) works identically.

Example

client = Miosa.client("msk_u_...")

{:ok, sandbox} = Miosa.Sandboxes.create(client, %{name: "quick-exec"})
:ok = Miosa.Computer.start(client, sandbox.id)
{:ok, %{output: out}} = Miosa.Exec.run(client, sandbox.id, command: "echo hi")
:ok = Miosa.Computer.destroy(client, sandbox.id)

Summary

Functions

create(client, attrs)

Create a sandbox — a computer provisioned with the miosa-sandbox template.

delete(client, id)

Destroy a sandbox. Alias for Miosa.Computers.delete/2.

get(client, id)

Get a sandbox by ID. Alias for Miosa.Computers.get/2.

list(client)

List sandboxes — filtered to computers whose template_type is "miosa-sandbox".

readiness(client, sandbox_id)

Return the readiness-probe state for a sandbox (GET /sandboxes/:sandbox_id/readiness).

template()

Template slug used for the lightweight code-exec sandbox rootfs.

wait_until_ready(client, sandbox_id, opts \\ [])

Block until the sandbox reports ready, or timeout seconds elapse.

Functions

create(client, attrs)

@spec create(Miosa.Client.t(), map()) :: Miosa.Client.result(Miosa.Types.Computer.t())

Create a sandbox — a computer provisioned with the miosa-sandbox template.

Accepts the same attributes as Miosa.Computers.create/2; the template_type key defaults to "miosa-sandbox" when omitted.

White-label attribution

Pass :external_workspace_id, :external_user_id, :external_project_id to tag the sandbox with your platform's customer/user/project IDs. These fields never authorize anything — tenancy is always derived server-side from the API key — but they let your list/usage APIs group by attribution.

{:ok, sandbox} = Miosa.Sandboxes.create(client, %{
  name: "smile-dental",
  external_workspace_id: "dental-office-123",
  external_user_id: "dr-smith-456",
  external_project_id: "landing-page-789"
})