---
title: OfflineTestRunner
seo:
  title: OfflineTestRunner — TypeScript SDK
  description: >-
    Executes the offline-test lifecycle for a test config: resolve the dataset
    version, optionally run the agent to produce offline traces, create the test
    run, wait for terminal status, fetch results, evaluate the pass condition,
    and report successes. (TypeScript SDK)
description: >-
  Executes the offline-test lifecycle for a test config: resolve the dataset
  version, optionally run the agent to produce offline traces, create the test
  run, wait for terminal status, fetch results, evaluate the pass condition, and
  report successes.
---

## runAgent()

Run the agent once per dataset example, producing one offline trace each.

NOTE: the offline-tracer lifecycle here (active-tracer swap, async
`observe`, per-example trace attribution) still needs validation against a
live run.

```typescript
async function runAgent(agentFunction: AgentFunction, examples: ExampleRow[]): Promise<Record<string, string>>
```

### Parameters

| Prop | Type | Default | Description |
| - | - | - | - |
| `agentFunction` | `AgentFunction` | - | |
| `examples` | `ExampleRow[]` | - | |

### Returns

`Promise<Record<string, string>>`