AIDK

Appearance

AIDK API Reference / aidk-shared/testing

aidk-shared/testing ​

AIDK Testing Utilities ​

Fixtures, mocks, and helpers for testing AIDK applications. Import from aidk-shared/testing for test utilities.

Features ​

  • Fixtures - Factory functions for messages, blocks, tools
  • Stream Helpers - Create and capture async generators
  • SSE Utilities - Parse and format Server-Sent Events
  • Mock Utilities - Spies, mocks, and sequences

Quick Start ​

typescript
import {
  createUserMessage,
  createAssistantMessage,
  createTextStreamSequence,
  captureAsyncGenerator,
  waitForEvent,
} from 'aidk-shared/testing';

// Create test fixtures
const messages = [
  createUserMessage('Hello'),
  createAssistantMessage('Hi there!'),
];

// Create stream sequences
const chunks = createTextStreamSequence('Hello world');

// Capture async generator output
const items = await captureAsyncGenerator(myStream());

References ​

arrayToAsyncGenerator ​

Re-exports arrayToAsyncGenerator

captureAsyncGenerator ​

Re-exports captureAsyncGenerator

createAgentToolCall ​

Re-exports createAgentToolCall

createAgentToolResult ​

Re-exports createAgentToolResult

createAssistantMessage ​

Re-exports createAssistantMessage

createBase64ImageBlock ​

Re-exports createBase64ImageBlock

createCodeBlock ​

Re-exports createCodeBlock

createContentDeltaEvent ​

Re-exports createContentDeltaEvent

createContentEndEvent ​

Re-exports createContentEndEvent

createContentEvent ​

Re-exports createContentEvent

createContentStartEvent ​

Re-exports createContentStartEvent

createControllableGenerator ​

Re-exports createControllableGenerator

createConversation ​

Re-exports createConversation

createDeferred ​

Re-exports createDeferred

createEngineErrorEvent ​

Re-exports createEngineErrorEvent

createErrorToolResultBlock ​

Re-exports createErrorToolResultBlock

createErrorToolResultEvent ​

Re-exports createErrorToolResultEvent

createEventBase ​

Re-exports createEventBase

createExecutionCompleteEvent ​

Re-exports createExecutionCompleteEvent

createExecutionEndEvent ​

Re-exports createExecutionEndEvent

createExecutionStartEvent ​

Re-exports createExecutionStartEvent

createForkEndEvent ​

Re-exports createForkEndEvent

createForkEventSequence ​

Re-exports createForkEventSequence

createForkStartEvent ​

Re-exports createForkStartEvent

createImageBlock ​

Re-exports createImageBlock

createMessageCompleteEvent ​

Re-exports createMessageCompleteEvent

createMessageEndChunk ​

Re-exports createMessageEndChunk

createMessageEndEvent ​

Re-exports createMessageEndEvent

createMessageStartChunk ​

Re-exports createMessageStartChunk

createMessageStartEvent ​

Re-exports createMessageStartEvent

createMock ​

Re-exports createMock

createMockSequence ​

Re-exports createMockSequence

createReasoningBlock ​

Re-exports createReasoningBlock

createReasoningCompleteEvent ​

Re-exports createReasoningCompleteEvent

createReasoningDeltaEvent ​

Re-exports createReasoningDeltaEvent

createReasoningEndEvent ​

Re-exports createReasoningEndEvent

createReasoningStartEvent ​

Re-exports createReasoningStartEvent

createSpawnEndEvent ​

Re-exports createSpawnEndEvent

createSpawnEventSequence ​

Re-exports createSpawnEventSequence

createSpawnStartEvent ​

Re-exports createSpawnStartEvent

createSpy ​

Re-exports createSpy

createStreamChunk ​

Re-exports createStreamChunk

createStreamErrorEvent ​

Re-exports createStreamErrorEvent

createSystemMessage ​

Re-exports createSystemMessage

createTextBlock ​

Re-exports createTextBlock

createTextDeltaChunk ​

Re-exports createTextDeltaChunk

createTextStreamEventSequence ​

Re-exports createTextStreamEventSequence

createTextStreamSequence ​

Re-exports createTextStreamSequence

createTickCompleteEvent ​

Re-exports createTickCompleteEvent

createTickEndEvent ​

Re-exports createTickEndEvent

createTickStartEvent ​

Re-exports createTickStartEvent

createTokenUsage ​

Re-exports createTokenUsage

createToolCallChunk ​

Re-exports createToolCallChunk

createToolCallCompleteEvent ​

Re-exports createToolCallCompleteEvent

createToolCallDeltaEvent ​

Re-exports createToolCallDeltaEvent

createToolCallEndEvent ​

Re-exports createToolCallEndEvent

createToolCallEventSequence ​

Re-exports createToolCallEventSequence

createToolCallStartEvent ​

Re-exports createToolCallStartEvent

createToolCallStreamSequence ​

Re-exports createToolCallStreamSequence

createToolConfirmationRequiredEvent ​

Re-exports createToolConfirmationRequiredEvent

createToolConfirmationResultEvent ​

Re-exports createToolConfirmationResultEvent

createToolDefinition ​

Re-exports createToolDefinition

createToolMessage ​

Re-exports createToolMessage

createToolResultBlock ​

Re-exports createToolResultBlock

createToolResultChunk ​

Re-exports createToolResultChunk

createToolResultEvent ​

Re-exports createToolResultEvent

createToolUseBlock ​

Re-exports createToolUseBlock

createUserMessage ​

Re-exports createUserMessage

formatSSEEvent ​

Re-exports formatSSEEvent

parseSSEBuffer ​

Re-exports parseSSEBuffer

parseSSEEvent ​

Re-exports parseSSEEvent

resetTestIds ​

Re-exports resetTestIds

sleep ​

Re-exports sleep

testId ​

Re-exports testId

waitFor ​

Re-exports waitFor

waitForEvent ​

Re-exports waitForEvent

waitForEvents ​

Re-exports waitForEvents

Released under the MIT License.

Copyright 2024-present