---
url: >-
  https://adk.nht.io/api/@nhtio/adk/batteries/sandbox/interfaces/SandboxMediaOptions.md
description: 'Arguments for [`createSandboxMedia`](https://adk.nht.io/api/@nhtio/adk/batteries/sandbox/functions/createSandboxMedia).'
---

# Interface: SandboxMediaOptions

Defined in: [src/batteries/sandbox/media\_reader.ts:64](https://github.com/NHTIO/ADK/blob/v1.20260824.1/src/src/batteries/sandbox/media_reader.ts#L64)

Arguments for [createSandboxMedia](../functions/createSandboxMedia.md).

## Extends

* [`SandboxMediaReaderOptions`](SandboxMediaReaderOptions.md)

## Properties

| Property                                        | Type                                                                 | Description                                                                             | Inherited from                                                                                                                 | Defined in                                                                                                                                |
| ----------------------------------------------- | -------------------------------------------------------------------- | --------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------- |
|  `epoch`             | [`SandboxEpoch`](../classes/SandboxEpoch.md)                         | The epoch held by the sandbox handle when this reader was issued.                       | [`SandboxMediaReaderOptions`](SandboxMediaReaderOptions.md).[`epoch`](SandboxMediaReaderOptions.md#property-epoch)             | [src/batteries/sandbox/media\_reader.ts:17](https://github.com/NHTIO/ADK/blob/v1.20260824.1/src/src/batteries/sandbox/media_reader.ts#L17) |
|  `filename`       | `string`                                                             | Model-visible source filename.                                                          | -                                                                                                                              | [src/batteries/sandbox/media\_reader.ts:70](https://github.com/NHTIO/ADK/blob/v1.20260824.1/src/src/batteries/sandbox/media_reader.ts#L70) |
|  `fileSystem`   | [`SandboxFileSystem`](SandboxFileSystem.md)                          | The filesystem capability belonging to the sandbox handle.                              | [`SandboxMediaReaderOptions`](SandboxMediaReaderOptions.md).[`fileSystem`](SandboxMediaReaderOptions.md#property-filesystem)   | [src/batteries/sandbox/media\_reader.ts:13](https://github.com/NHTIO/ADK/blob/v1.20260824.1/src/src/batteries/sandbox/media_reader.ts#L13) |
|  `isEpochLive` | [`SandboxEpochIsLive`](../type-aliases/SandboxEpochIsLive.md)        | Predicate owned by the sandbox manager; this reader never issues or invalidates epochs. | [`SandboxMediaReaderOptions`](SandboxMediaReaderOptions.md).[`isEpochLive`](SandboxMediaReaderOptions.md#property-isepochlive) | [src/batteries/sandbox/media\_reader.ts:19](https://github.com/NHTIO/ADK/blob/v1.20260824.1/src/src/batteries/sandbox/media_reader.ts#L19) |
|  `kind`               | `"document"` | `"audio"` | `"image"` | `"video"`                  | Media modality assigned by the stage operation.                                         | -                                                                                                                              | [src/batteries/sandbox/media\_reader.ts:66](https://github.com/NHTIO/ADK/blob/v1.20260824.1/src/src/batteries/sandbox/media_reader.ts#L66) |
|  `mimeType`       | `string`                                                             | MIME type resolved by the stage operation.                                              | -                                                                                                                              | [src/batteries/sandbox/media\_reader.ts:68](https://github.com/NHTIO/ADK/blob/v1.20260824.1/src/src/batteries/sandbox/media_reader.ts#L68) |
|  `path`               | `string`                                                             | The already translated backend path.                                                    | [`SandboxMediaReaderOptions`](SandboxMediaReaderOptions.md).[`path`](SandboxMediaReaderOptions.md#property-path)               | [src/batteries/sandbox/media\_reader.ts:15](https://github.com/NHTIO/ADK/blob/v1.20260824.1/src/src/batteries/sandbox/media_reader.ts#L15) |
|  `source?`          | `string`                                                             | Optional provenance label retained on the Media value.                                  | -                                                                                                                              | [src/batteries/sandbox/media\_reader.ts:74](https://github.com/NHTIO/ADK/blob/v1.20260824.1/src/src/batteries/sandbox/media_reader.ts#L74) |
|  `trustTier`     | `"first-party"` | `"third-party-public"` | `"third-party-private"` | Configuration-supplied provenance tier.                                                 | -                                                                                                                              | [src/batteries/sandbox/media\_reader.ts:72](https://github.com/NHTIO/ADK/blob/v1.20260824.1/src/src/batteries/sandbox/media_reader.ts#L72) |