---
url: 'https://adk.nht.io/api/@nhtio/adk/types/type-aliases/ToolsRetrievalFn.md'
description: A function that retrieves the tools available for the current turn.
---

# Type Alias: ToolsRetrievalFn

```ts
type ToolsRetrievalFn = (ctx: TurnContext) => Tool[] | Promise<Tool[]>;
```

Defined in: [lib/contracts/turn\_runner\_context.ts:143](https://github.com/NHTIO/ADK/blob/v1.20260605.0/src/lib/contracts/turn_runner_context.ts#L143)

A function that retrieves the tools available for the current turn.

## Parameters

| Parameter | Type                                          |
| --------- | --------------------------------------------- |
| `ctx`     | [`TurnContext`](../interfaces/TurnContext.md) |

## Returns

| [`Tool`](../../forge/classes/Tool.md)\[]
| `Promise`<[`Tool`](../../forge/classes/Tool.md)\[]>

## Remarks

Receives the active [TurnContext](../interfaces/TurnContext.md) so implementations can apply turn-aware filtering
(e.g. RBAC scopes, feature flags). May be synchronous or asynchronous.