---
url: 'https://adk.nht.io/api/@nhtio/adk/batteries/media/interfaces/MediaPipeline.md'
description: >-
  The callable pipeline returned by [`createMediaPipeline`](https://adk.nht.io/api/@nhtio/adk/batteries/media/functions/createMediaPipeline): `mp(payload)`
  opens a chainable builder; `mp.query(payload, q)` runs a pipe-string
  statement;
---

# Interface: MediaPipeline()

Defined in: [src/batteries/media/index.ts:211](https://github.com/NHTIO/ADK/blob/v1.20260713.1/src/src/batteries/media/index.ts#L211)

The callable pipeline returned by [createMediaPipeline](../functions/createMediaPipeline.md): `mp(payload)` opens a
chainable builder; `mp.query(payload, q)` runs a pipe-string statement; `mp.ops(payload,
ops)` runs a JSON ops array. All three compile to the same plan and execute on the same
runtime.

```ts
MediaPipeline(input: StepPayload): MediaChain;
```

Defined in: [src/batteries/media/index.ts:213](https://github.com/NHTIO/ADK/blob/v1.20260713.1/src/src/batteries/media/index.ts#L213)

Open a fresh chainable builder over `input`.

## Parameters

| Parameter | Type                            |
| --------- | ------------------------------- |
| `input`   | [`StepPayload`](StepPayload.md) |

## Returns

[`MediaChain`](../classes/MediaChain.md)

## Properties

| Property                                          | Modifier   | Type                                                               | Description                                                                                                                                                            | Defined in                                                                                                                |
| ------------------------------------------------- | ---------- | ------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------- |
|  `capabilities` | `readonly` | [`EngineRegistry`](EngineRegistry.md)                              | The deployment's engine registry (drives verb narrowing AND generation/edit dispatch — the runtime value has always been the registry; the declared type now says so). | [src/batteries/media/index.ts:224](https://github.com/NHTIO/ADK/blob/v1.20260713.1/src/src/batteries/media/index.ts#L224) |
|  `engines`           | `readonly` | readonly [`MediaEngine`](../contracts/interfaces/MediaEngine.md)\[] | The resolved engines, in supply order — inspect ids and declared capabilities.                                                                                         | [src/batteries/media/index.ts:226](https://github.com/NHTIO/ADK/blob/v1.20260713.1/src/src/batteries/media/index.ts#L226) |

## Methods

### compile()

```ts
compile(statement: string | MediaOp[]): MediaPlan;
```

Defined in: [src/batteries/media/index.ts:219](https://github.com/NHTIO/ADK/blob/v1.20260713.1/src/src/batteries/media/index.ts#L219)

Validate a pipe string or ops array to a plan WITHOUT executing (dry-run/compile).

#### Parameters

| Parameter   | Type                                  |
| ----------- | ------------------------------------- |
| `statement` | `string` | [`MediaOp`](MediaOp.md)\[] |

#### Returns

[`MediaPlan`](MediaPlan.md)

***

### ops()

```ts
ops(
   input: StepPayload,
   ops: MediaOp[],
options?: RunOptions): Promise<StepResult>;
```

Defined in: [src/batteries/media/index.ts:217](https://github.com/NHTIO/ADK/blob/v1.20260713.1/src/src/batteries/media/index.ts#L217)

Validate and execute a JSON ops array.

#### Parameters

| Parameter  | Type                            |
| ---------- | ------------------------------- |
| `input`    | [`StepPayload`](StepPayload.md) |
| `ops`      | [`MediaOp`](MediaOp.md)\[]       |
| `options?` | [`RunOptions`](RunOptions.md)   |

#### Returns

`Promise`<[`StepResult`](../type-aliases/StepResult.md)>

***

### query()

```ts
query(
   input: StepPayload,
   q: string,
options?: RunOptions): Promise<StepResult>;
```

Defined in: [src/batteries/media/index.ts:215](https://github.com/NHTIO/ADK/blob/v1.20260713.1/src/src/batteries/media/index.ts#L215)

Parse, validate, and execute a pipe-string statement.

#### Parameters

| Parameter  | Type                            |
| ---------- | ------------------------------- |
| `input`    | [`StepPayload`](StepPayload.md) |
| `q`        | `string`                        |
| `options?` | [`RunOptions`](RunOptions.md)   |

#### Returns

`Promise`<[`StepResult`](../type-aliases/StepResult.md)>