---
url: >-
  https://adk.nht.io/api/@nhtio/adk/batteries/media/forge/interfaces/ForgeMediaToolsOptions.md
description: 'Options for [`forgeMediaTools`](https://adk.nht.io/api/@nhtio/adk/batteries/media/forge/functions/forgeMediaTools).'
---

# Interface: ForgeMediaToolsOptions

Defined in: [src/batteries/media/forge.ts:72](https://github.com/NHTIO/ADK/blob/v1.20260713.1/src/src/batteries/media/forge.ts#L72)

Options for [forgeMediaTools](../functions/forgeMediaTools.md).

## Properties

| Property                                           | Type                                                                                                                                                        | Description                                                                    | Defined in                                                                                                              |
| -------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------- |
|  `gate?`                 | [`ToolGateFn`](../type-aliases/ToolGateFn.md)                                                                                                               | Optional pre-execution gate (see [ToolGateFn](../type-aliases/ToolGateFn.md)). | [src/batteries/media/forge.ts:78](https://github.com/NHTIO/ADK/blob/v1.20260713.1/src/src/batteries/media/forge.ts#L78) |
|  `overrides?`       | [`Record`](https://www.typescriptlang.org/docs/handbook/utility-types.html#recordkeys-type)<`string`, { `description?`: `string`; `name?`: `string`; }> | Per-tool name/description overrides, keyed by the minted tool's default name.  | [src/batteries/media/forge.ts:80](https://github.com/NHTIO/ADK/blob/v1.20260713.1/src/src/batteries/media/forge.ts#L80) |
|  `resolveMedia?` | [`MediaResolverFn`](../type-aliases/MediaResolverFn.md)                                                                                                     | Media-id resolution. Default: scan turn attachments + tool-call Media results. | [src/batteries/media/forge.ts:76](https://github.com/NHTIO/ADK/blob/v1.20260713.1/src/src/batteries/media/forge.ts#L76) |
|  `surface`            | `"composite"` | `"granular"`                                                                                                                               | Which tool surface to mint.                                                    | [src/batteries/media/forge.ts:74](https://github.com/NHTIO/ADK/blob/v1.20260713.1/src/src/batteries/media/forge.ts#L74) |