# `Insider.Sentinel.Sandbox.Executor`
[🔗](https://github.com/hiivemarkets/insider/blob/v0.1.0/tools/insider_lab/lib/insider/sentinel/sandbox/executor.ex#L1)

Fixed-capacity supervisor for provider-driven disposable target runs.

Provider modules are an explicit trusted allowlist configured at startup.

# `handle`

```elixir
@type handle() :: %{pid: pid(), token: reference()}
```

# `await`

```elixir
@spec await(handle(), timeout()) ::
  Insider.Protocol.Result.t() | {:error, Insider.Protocol.Error.t()}
```

# `cancel`

```elixir
@spec cancel(handle(), timeout()) :: :ok | {:error, Insider.Protocol.Error.t()}
```

# `child_spec`

Returns a specification to start this module under a supervisor.

See `Supervisor`.

# `counts`

```elixir
@spec counts(Supervisor.supervisor()) ::
  {:ok, %{active: non_neg_integer(), quarantined: non_neg_integer()}}
  | {:error, Insider.Protocol.Error.t()}
```

# `run`

```elixir
@spec run(Supervisor.supervisor(), Insider.Sentinel.Sandbox.Target.t(), keyword()) ::
  Insider.Protocol.Result.t() | {:error, Insider.Protocol.Error.t()}
```

# `start_link`

```elixir
@spec start_link(keyword()) :: Supervisor.on_start()
```

# `start_run`

```elixir
@spec start_run(
  Supervisor.supervisor(),
  Insider.Sentinel.Sandbox.Target.t(),
  keyword()
) ::
  {:ok, handle()} | {:error, Insider.Protocol.Error.t()}
```

---

*Consult [api-reference.md](api-reference.md) for complete listing*
