> ## Documentation Index
> Fetch the complete documentation index at: https://icrl.dev/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# TrajectoryRetriever

> Step-level retriever for in-context learning

## Constructor

```ts theme={null}
new TrajectoryRetriever(database: TrajectoryDatabase, k?: number)
```

`k` defaults to 2.

## Methods

```ts theme={null}
await retriever.retrieveForPlan(goal, k?)
await retriever.retrieveForStep(goal, plan, observation, k?)
retriever.getRetrievedIds()
retriever.clearRetrieved()
retriever.recordEpisodeResult(success)
```

* `retrieveForPlan` — examples for planning phase (query: goal)
* `retrieveForStep` — examples for reasoning/acting step (query: goal + observation)
* `recordEpisodeResult` — call after episode ends to update curation metadata for retrieved trajectories
