---
url: >-
  https://adk.nht.io/api/@nhtio/adk/batteries/media/contracts/interfaces/ConvertCapability.md
description: >-
  One uniform block of an engine's conversion matrix: every format token in `to`
  is producible from every input matching `from`.
---

# Interface: ConvertCapability

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

One uniform block of an engine's conversion matrix: every format token in `to` is
producible from every input matching `from`.

## Remarks

Declarations are plain data — the registry reads them without calling engine code. An
input-dependent matrix (LibreOffice: docx→pdf yes, docx→xlsx no, ods→xlsx yes) is expressed
as several capability groups, each a uniform from×to block.

## Properties

| Property                          | Type                | Description                                        | Defined in                                                                                                                        |
| --------------------------------- | ------------------- | -------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------- |
|  `from` | readonly `string`\[] | Input patterns this block accepts.                 | [src/batteries/media/contracts.ts:293](https://github.com/NHTIO/ADK/blob/v1.20260713.1/src/src/batteries/media/contracts.ts#L293) |
|  `to`     | readonly `string`\[] | Format tokens producible from every `from` member. | [src/batteries/media/contracts.ts:295](https://github.com/NHTIO/ADK/blob/v1.20260713.1/src/src/batteries/media/contracts.ts#L295) |

## Methods

### convert()

```ts
convert(request: ConvertRequest): Promise<ConvertResult>;
```

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

Perform the conversion.

#### Parameters

| Parameter | Type                                  | Description                                 |
| --------- | ------------------------------------- | ------------------------------------------- |
| `request` | [`ConvertRequest`](ConvertRequest.md) | The input bytes, target token, and options. |

#### Returns

`Promise`<[`ConvertResult`](ConvertResult.md)>

The conversion outputs.