@spec get(Miosa.Client.t(), String.t(), String.t()) :: Miosa.Client.result(map())

Get a single process by PID (GET /sandboxes/:sandbox_id/processes/:pid).

@spec kill(Miosa.Client.t(), String.t(), String.t()) ::
  :ok | {:error, Miosa.Error.t()}

Alias for stop/3 (kept for backwards-compat).

@spec list(Miosa.Client.t(), String.t()) :: Miosa.Client.result(list())

List all running background processes in the sandbox (GET /sandboxes/:sandbox_id/processes).

@spec logs(Miosa.Client.t(), String.t(), String.t(), pos_integer()) ::
  Miosa.Client.result(String.t())

Fetch the last tail lines of logs for a process (GET /sandboxes/:sandbox_id/processes/:pid/logs?tail=N).

@spec send_stdin(Miosa.Client.t(), String.t(), String.t(), String.t()) ::
  Miosa.Client.result(map())

Send data to the stdin of a running background process (POST /sandboxes/:sandbox_id/processes/:pid/stdin).

@spec start(Miosa.Client.t(), String.t(), String.t(), map()) ::
  Miosa.Client.result(map())

Start a background process in the sandbox (POST /sandboxes/:sandbox_id/processes).

Options map keys

• "cwd" — Working directory for the process.
• "env" — Environment variables map.
• "timeout" — Process timeout in seconds.

@spec stop(Miosa.Client.t(), String.t(), String.t()) ::
  :ok | {:error, Miosa.Error.t()}

Stop (SIGTERM → SIGKILL after 5 s) a background process by its PID (DELETE /sandboxes/:sandbox_id/processes/:pid).