---
url: 'https://adk.nht.io/api/@nhtio/adk/types/type-aliases/MemoryRetrievalFn.md'
description: A function that retrieves the memories relevant to the current turn.
---

# Type Alias: MemoryRetrievalFn

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

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

A function that retrieves the memories relevant to the current turn.

## Parameters

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

## Returns

| [`Memory`](../../common/classes/Memory.md)\[]
| `Promise`<[`Memory`](../../common/classes/Memory.md)\[]>

## Remarks

Receives the active [TurnContext](../interfaces/TurnContext.md) so implementations can filter or rank memories
based on turn-specific state (e.g. the system prompt, standing instructions, or stash).
May be synchronous or asynchronous.