---
url: >-
  https://adk.nht.io/api/@nhtio/adk/batteries/media/contracts/interfaces/BinaryInvocation.md
description: 'A single binary invocation handed to a [`BinaryExecutor`](https://adk.nht.io/api/@nhtio/adk/batteries/media/contracts/interfaces/BinaryExecutor).'
---

# Interface: BinaryInvocation

Defined in: [src/batteries/media/contracts.ts:67](https://github.com/NHTIO/ADK/blob/v1.20260713.1/src/src/batteries/media/contracts.ts#L67)

A single binary invocation handed to a [BinaryExecutor](BinaryExecutor.md).

## Properties

| Property                                     | Type          | Description                                                               | Defined in                                                                                                                      |
| -------------------------------------------- | ------------- | ------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------- |
|  `args`            | `string`\[]    | Arguments, exec-style (no shell interpolation).                           | [src/batteries/media/contracts.ts:71](https://github.com/NHTIO/ADK/blob/v1.20260713.1/src/src/batteries/media/contracts.ts#L71) |
|  `cmd`              | `string`      | The command to run (an absolute path or a name the executor can resolve). | [src/batteries/media/contracts.ts:69](https://github.com/NHTIO/ADK/blob/v1.20260713.1/src/src/batteries/media/contracts.ts#L69) |
|  `signal?`       | `AbortSignal` | Abort signal to cancel the invocation.                                    | [src/batteries/media/contracts.ts:75](https://github.com/NHTIO/ADK/blob/v1.20260713.1/src/src/batteries/media/contracts.ts#L75) |
|  `timeoutMs?` | `number`      | Wall-clock timeout in milliseconds.                                       | [src/batteries/media/contracts.ts:73](https://github.com/NHTIO/ADK/blob/v1.20260713.1/src/src/batteries/media/contracts.ts#L73) |