---
url: >-
  https://adk.nht.io/api/@nhtio/adk/batteries/sandbox/type-aliases/SandboxEvent.md
description: Typed records emitted by the sandbox's single audit firehose.
---

# Type Alias: SandboxEvent

```ts
type SandboxEvent =
  | {
      command: string;
      kind: "bypass";
      loud: true;
      path?: string;
    }
  | {
      handleId: string;
      kind: "unsandboxed-fallback";
      loud: true;
      path?: string;
      reason: string;
    }
  | {
      comparison?: "network-domains";
      kind: "drift-check";
      outcome: "passed" | "failed" | "skipped";
      path?: string;
      reason?: string;
    }
  | {
      kind: "fs-node-version";
      version: string;
    }
  | {
      kind: "dependency-warnings";
      warnings: readonly string[];
    };
```

Defined in: [src/batteries/sandbox/observability.ts:11](https://github.com/NHTIO/ADK/blob/v1.20260824.1/src/src/batteries/sandbox/observability.ts#L11)

Typed records emitted by the sandbox's single audit firehose.

## Union Members

### Type Literal

```ts
{
  command: string;
  kind: "bypass";
  loud: true;
  path?: string;
}
```

***

### Type Literal

```ts
{
  handleId: string;
  kind: "unsandboxed-fallback";
  loud: true;
  path?: string;
  reason: string;
}
```

***

### Type Literal

```ts
{
  comparison?: "network-domains";
  kind: "drift-check";
  outcome: "passed" | "failed" | "skipped";
  path?: string;
  reason?: string;
}
```

| Name          | Type                                    | Description                                                            | Defined in                                                                                                                                  |
| ------------- | --------------------------------------- | ---------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------- |
| `comparison?` | `"network-domains"`                     | `skipped` is specifically the network-domain comparison, not adoption. | [src/batteries/sandbox/observability.ts:31](https://github.com/NHTIO/ADK/blob/v1.20260824.1/src/src/batteries/sandbox/observability.ts#L31) |
| `kind`        | `"drift-check"`                         | -                                                                      | [src/batteries/sandbox/observability.ts:26](https://github.com/NHTIO/ADK/blob/v1.20260824.1/src/src/batteries/sandbox/observability.ts#L26) |
| `outcome`     | `"passed"` | `"failed"` | `"skipped"` | -                                                                      | [src/batteries/sandbox/observability.ts:27](https://github.com/NHTIO/ADK/blob/v1.20260824.1/src/src/batteries/sandbox/observability.ts#L27) |
| `path?`       | `string`                                | -                                                                      | [src/batteries/sandbox/observability.ts:29](https://github.com/NHTIO/ADK/blob/v1.20260824.1/src/src/batteries/sandbox/observability.ts#L29) |
| `reason?`     | `string`                                | -                                                                      | [src/batteries/sandbox/observability.ts:28](https://github.com/NHTIO/ADK/blob/v1.20260824.1/src/src/batteries/sandbox/observability.ts#L28) |

***

### Type Literal

```ts
{
  kind: "fs-node-version";
  version: string;
}
```

***

### Type Literal

```ts
{
  kind: "dependency-warnings";
  warnings: readonly string[];
}
```