Testing Installation

Installation

Add @llmist/testing as a dev dependency:

bun

bun add -D @llmist/testing

npm

npm install -D @llmist/testing

pnpm

pnpm add -D @llmist/testing

yarn

yarn add -D @llmist/testing

Note

@llmist/testing has llmist as a peer dependency. Make sure you have llmist installed in your project.

Test Setup

With Vitest

test/setup.ts

import { beforeEach } from 'vitest';
import { getMockManager } from '@llmist/testing';

beforeEach(() => {
  // Clear all registered mocks before each test
  getMockManager().clear();
});

Configure in vitest.config.ts:

vitest.config.ts

import { defineConfig } from 'vitest/config';

export default defineConfig({
  test: {
    setupFiles: ['./test/setup.ts'],
  },
});

With Jest

test/setup.ts

import { getMockManager } from '@llmist/testing';

beforeEach(() => {
  getMockManager().clear();
});

Configure in jest.config.js:

jest.config.js

module.exports = {
  setupFilesAfterEnv: ['./test/setup.ts'],
};

Basic Usage Pattern

1. Import testing utilities

   import { mockLLM, createMockClient } from '@llmist/testing';

2. Register mock responses

   mockLLM()
     .forAnyModel()
     .whenMessageContains('hello')
     .returns('Hi there!')
     .register();

3. Create a mock client

   const client = createMockClient();

4. Run your agent

   const response = await client.createAgent()
     .withModel('sonnet')
     .askAndCollect('hello world');

5. Assert on the response

   expect(response).toContain('Hi there!');

Next Steps

Now that you have testing set up, continue to the Quick Start to write your first mock test!