Class RunAssert

Access a specific event by index for assertions. Supports negative indices (e.g., -1 for last event).

Example

result.expect.at(0).isMessage({ role: 'user' });
result.expect.at(-1).isMessage({ role: 'assistant' });
Copy

Assert that an agent handoff matching criteria exists anywhere in the events.

Example

result.expect.containsAgentHandoff({ newAgentType: MyAgent });
Copy

Assert that a function call matching criteria exists anywhere in the events.

Example

result.expect.containsFunctionCall({ name: 'order_item' });
Copy

Assert that a function call output matching criteria exists anywhere in the events.

Example

result.expect.containsFunctionCallOutput({ isError: false });
Copy

Assert that a message matching criteria exists anywhere in the events.

Example

result.expect.containsMessage({ role: 'assistant' });
Copy

Advance to the next event, optionally filtering by type.

Example

result.expect.nextEvent().isMessage({ role: 'assistant' });
result.expect.nextEvent({ type: 'function_call' }).isFunctionCall({ name: 'foo' });
Copy

Assert that there are no further events.

Example

result.expect.noMoreEvents();
Copy

Get an EventRangeAssert for a range of events. Similar to Python's slice access: expect[0:3] or expect[:]

Example

// Search all events
result.expect.range().containsFunctionCall({ name: 'foo' });
// Search first 3 events
result.expect.range(0, 3).containsMessage({ role: 'assistant' });
Copy

Skip a specified number of upcoming events without assertions.

Example

result.expect.skipNext(2);
Copy

Conditionally skip the next event if it matches the specified criteria. Returns the event assertion if matched and skipped, or undefined if not matched.

Example

// Skip optional assistant message before function call
result.expect.skipNextEventIf({ type: 'message', role: 'assistant' });
result.expect.nextEvent().isFunctionCall({ name: 'foo' });
Copy