testAgent

testAgent(agent, opts): Promise<TestResult>

Declarative test helper for Agent Express agents.

Supports single-turn (string input) and multi-turn (string[] input). For multi-turn, creates a session and runs each input as a turn.

Parameters

agent

Agent

The Agent instance to test

opts

TestOptions

Input and optional assertions

Returns

Promise<TestResult>

TestResult with pass/fail and details

Example

// Single turn
const result = await testAgent(agent, {
  input: "Hello",
  expect: { outputContains: "Hi" },
})

// Multi-turn
const result = await testAgent(agent, {
  input: ["Hello", "What did I say?"],
  expect: { outputContains: "Hello" },
})