@copilotkit/aimock 1.43.0 → 1.45.0

package/dist/index.d.ts

@@ -1,9 +1,13 @@
+import { MisbehaviorRule } from "./misbehavior.js";
 import { DEFAULT_TEST_ID } from "./constants.js";
 import { Journal, isChatCompletionBody } from "./journal.js";
 import { LiveBinding, LiveEntry, LiveFailureCategory, LiveFixtureResponse, LiveJson, LiveMode, LiveObject, LiveOptions, LivePosition, LiveTranscript } from "./live-types.js";
 import { LogLevel, Logger } from "./logger.js";
+import { ROUTE_DEFINITIONS, RouteDefinition } from "./route-registry.js";
 import { MetricsRegistry, createMetricsRegistry, normalizePathLabel } from "./metrics.js";
-import { ApiKeyAuthConfig, AudioResponse, ChaosAction, ChaosConfig, ChatCompletion, ChatCompletionChoice, ChatCompletionMessage, ChatCompletionRequest, ChatMessage, ContentPart, ContentWithToolCallsResponse, EmbeddingFixtureOpts, EmbeddingResponse, ErrorResponse, Fixture, FixtureBlock, FixtureFile, FixtureFileContentWithToolCallsResponse, FixtureFileEntry, FixtureFileResponse, FixtureFileTextResponse, FixtureFileToolCall, FixtureFileToolCallResponse, FixtureMatch, FixtureOpts, FixtureResponse, ImageItem, ImageResponse, JournalBody, JournalEntry, MockServerOptions, Mountable, RawJSONResponse, RecordConfig, RecordProviderKey, ResponseOverrides, SSEChoice, SSEChunk, SSEDelta, SSEToolCallDelta, StreamingProfile, TextResponse, ToolCall, ToolCallMessage, ToolCallResponse, ToolDefinition, TranscriptionResponse, VideoResponse, VoiceDesignPreview, VoiceDesignResponse } from "./types.js";
+import { FixtureLoadError, FixtureLoadErrorJSON, MisbehaviorConfigError, MisbehaviorConfigErrorJSON, ValidationRef, ValidationResult, loadFixtureFile, loadFixturesFromDir, normalizeResponse, renderValidationRef, validateFixtures } from "./fixture-loader.js";
+import { McpFakeAddOrigin, McpFakeAddResult, McpFakeBlockSnapshot, McpFakeDeclaredEntry, McpFakeIssue, McpFakeReportEvent, McpFakeReportPart, McpFakesAddError, McpFakesAddErrorJSON, RecordReplayLoadRule } from "./mcp-fakes.js";
+import { ApiKeyAuthConfig, AudioResponse, ChaosAction, ChaosConfig, ChatCompletion, ChatCompletionChoice, ChatCompletionMessage, ChatCompletionRequest, ChatMessage, ContentPart, ContentWithToolCallsResponse, CustomToolCall, CustomToolCallMessage, CustomToolDefinition, EmbeddingFixtureOpts, EmbeddingResponse, ErrorResponse, Fixture, FixtureBlock, FixtureFile, FixtureFileContentWithToolCallsResponse, FixtureFileCustomToolCall, FixtureFileEntry, FixtureFileResponse, FixtureFileResponsesBlock, FixtureFileTextResponse, FixtureFileToolCall, FixtureFileToolCallResponse, FixtureMatch, FixtureOpts, FixtureResponse, FixtureToolCall, ImageItem, ImageResponse, JournalBody, JournalEntry, MCP_FAKE_ERROR_CODES, McpFakeAnnotations, McpFakeBlock, McpFakeCall, McpFakeCallAnswer, McpFakeCallMatch, McpFakeContentBlock, McpFakeDeepReadonly, McpFakeErrorCode, McpFakeFullResult, McpFakeIcon, McpFakeIdentity, McpFakeNotification, McpFakeOutcome, McpFakeRecorded, McpFakeResourceContents, McpFakeResult, McpFakeScope, McpFakeSource, McpFakeStructuredResult, McpFakeTool, McpFakeUndeclaredPolicy, McpRecordConfig, MisbehaviorConfig, MisbehaviorFault, MisbehaviorFaultId, MockServerOptions, Mountable, RawJSONResponse, RecordConfig, RecordProviderKey, ResponseOverrides, ResponsesFixtureBlock, ResponsesToolsMode, SSEChoice, SSEChunk, SSEDelta, SSEToolCallDelta, StreamingProfile, TextResponse, ToolCall, ToolCallMessage, ToolCallResponse, ToolDefinition, TranscriptionResponse, VideoResponse, VoiceDesignPreview, VoiceDesignResponse } from "./types.js";
 import { A2AAgentDefinition, A2AArtifact, A2AMessage, A2AMockOptions, A2APart, A2ARole, A2AStreamEvent, A2ATask, A2ATaskResponse, A2ATaskState } from "./a2a-types.js";
 import { A2AMock } from "./a2a-mock.js";
 import { AGUIActivityDeltaEvent, AGUIActivitySnapshotEvent, AGUIBaseEvent, AGUICustomEvent, AGUIEvent, AGUIEventType, AGUIFixture, AGUIFixtureMatch, AGUIInterrupt, AGUIMessage, AGUIMessageContentPart, AGUIMessageRole, AGUIMessagesSnapshotEvent, AGUIMockOptions, AGUIRawEvent, AGUIReasoningEncryptedValueEvent, AGUIReasoningEncryptedValueSubtype, AGUIReasoningEndEvent, AGUIReasoningMessageChunkEvent, AGUIReasoningMessageContentEvent, AGUIReasoningMessageEndEvent, AGUIReasoningMessageStartEvent, AGUIReasoningStartEvent, AGUIRecordConfig, AGUIResumeEntry, AGUIRunAgentInput, AGUIRunErrorEvent, AGUIRunFinishedEvent, AGUIRunFinishedOutcome, AGUIRunStartedEvent, AGUIStateDeltaEvent, AGUIStateSnapshotEvent, AGUIStepFinishedEvent, AGUIStepStartedEvent, AGUISubagentErrorEvent, AGUISubagentFinishedEvent, AGUISubagentFinishedOutcome, AGUISubagentStartedEvent, AGUITextMessageChunkEvent, AGUITextMessageContentEvent, AGUITextMessageEndEvent, AGUITextMessageRole, AGUITextMessageStartEvent, AGUIThinkingEndEvent, AGUIThinkingStartEvent, AGUIThinkingTextMessageContentEvent, AGUIThinkingTextMessageEndEvent, AGUIThinkingTextMessageStartEvent, AGUITokenUsage, AGUIToolCall, AGUIToolCallArgsEvent, AGUIToolCallChunkEvent, AGUIToolCallEndEvent, AGUIToolCallResultEvent, AGUIToolCallStartEvent, AGUIToolDefinition } from "./agui-types.js";
@@ -23,7 +27,7 @@ import { VEO_VIDEO_MAX_ENTRIES, VeoVideoJobMap, handleVeoVideoCreate, handleVeoV
 import { GROK_VIDEO_MAX_ENTRIES, GrokVideoJobMap, handleGrokVideoCreate, handleGrokVideoStatus } from "./grok-video.js";
 import { BYTEPLUS_VIDEO_MAX_ENTRIES, BYTEPLUS_VIDEO_TASKS_PATH, BytePlusVideoJobMap, buildBytePlusMatchText, handleBytePlusVideoCreate, handleBytePlusVideoStatus } from "./byteplus-video.js";
 import { ServerInstance, ServiceFixtures, createServer } from "./server.js";
-import { ValidationRef, ValidationResult, loadFixtureFile, loadFixturesFromDir, normalizeResponse, renderValidationRef, validateFixtures } from "./fixture-loader.js";
+import { FixturesWithServices, loadFixtureFileWithServices, loadFixturesFromDirWithServices } from "./fixture-loader-services.js";
 import { MatchFixtureDiagnostic, getTextContent, matchFixture, matchFixtureDiagnostic } from "./router.js";
 import { ResponsesSSEEvent, buildContentWithToolCallsStreamEvents, buildTextStreamEvents, buildToolCallStreamEvents, handleResponses } from "./responses.js";
 import { handleMessages } from "./messages.js";
@@ -36,9 +40,11 @@ import { encodeEventStreamFrame, encodeEventStreamMessage, writeEventStream } fr
 import { NDJSONStreamOptions, writeNDJSONStream } from "./ndjson-writer.js";
 import { handleOllama, handleOllamaGenerate, ollamaToCompletionRequest } from "./ollama.js";
 import { cohereToCompletionRequest, handleCohere } from "./cohere.js";
+import { CATALOG_ROUTES, CatalogRoute, buildOpenApiDocument } from "./openapi.js";
 import { BatchObject, clearBatchStore, handleBatchesCancel, handleBatchesCreate, handleBatchesList, handleBatchesRetrieve } from "./batches.js";
 import { FileObject, clearFileStore, handleFilesContent, handleFilesCreate, handleFilesDelete, handleFilesList, handleFilesRetrieve } from "./files.js";
 import { FineTuningJob, FineTuningJobError, FineTuningJobEvent, FineTuningJobHyperparameters, FineTuningJobStatus, clearFineTuningStore, handleFineTuningCancel, handleFineTuningCreate, handleFineTuningEvents, handleFineTuningList, handleFineTuningRetrieve } from "./fine-tuning.js";
+import { VectorFileBatchObject, VectorFileBatchStatus, VectorSearchResult, VectorStoreFileObject, VectorStoreFileStatus, VectorStoreObject, VectorStoreStatus, clearVectorStoreStore, handleVectorFileBatchesCancel, handleVectorFileBatchesCreate, handleVectorFileBatchesFiles, handleVectorFileBatchesRetrieve, handleVectorStoreFilesCreate, handleVectorStoreFilesDelete, handleVectorStoreFilesList, handleVectorStoreFilesRetrieve, handleVectorStoresCreate, handleVectorStoresDelete, handleVectorStoresList, handleVectorStoresModify, handleVectorStoresRetrieve, handleVectorStoresSearch } from "./vector-stores.js";
 import { WebSocketConnection, WebSocketLimits, computeAcceptKey, upgradeToWebSocket } from "./ws-framing.js";
 import { handleWebSocketResponses } from "./ws-responses.js";
 import { handleWebSocketRealtime } from "./ws-realtime.js";
@@ -50,7 +56,7 @@ import { handleElevenLabsAudio } from "./elevenlabs-audio.js";
 import { clearElevenLabsVoices, handleElevenLabsVoiceCreate, handleElevenLabsVoiceDelete, handleElevenLabsVoiceDesign, handleElevenLabsVoiceGet, voiceDesignToJson } from "./elevenlabs-voice.js";
 import { handleFalQueue } from "./fal-audio.js";
 import { FalQueueStateMap, handleFal } from "./fal.js";
-import { EmbeddingAPIResponse, FORMAT_TO_CONTENT_TYPE, buildContentWithToolCallsChunks, buildContentWithToolCallsCompletion, buildEmbeddingResponse, buildTextChunks, buildTextCompletion, buildToolCallChunks, buildToolCallCompletion, extractOverrides, flattenHeaders, formatToMime, generateDeterministicEmbedding, generateId, generateMessageId, generateToolCallId, generateToolUseId, isAudioResponse, isContentWithToolCallsResponse, isEmbeddingResponse, isErrorResponse, isImageResponse, isLiveResponse, isTextResponse, isToolCallResponse, isTranscriptionResponse, isVideoResponse, resolveFixtureBlocks, resolveRequestId, strictNoMatchLogLine, strictNoMatchMessage } from "./helpers.js";
+import { EmbeddingAPIResponse, FORMAT_TO_CONTENT_TYPE, FunctionFixtureBlock, InvalidFixtureToolCallError, UnsupportedToolCallError, buildContentWithToolCallsChunks, buildContentWithToolCallsCompletion, buildEmbeddingResponse, buildTextChunks, buildTextCompletion, buildToolCallChunks, buildToolCallCompletion, extractOverrides, flattenHeaders, formatToMime, generateDeterministicEmbedding, generateId, generateMessageId, generateToolCallId, generateToolUseId, isAudioResponse, isContentWithToolCallsResponse, isEmbeddingResponse, isErrorResponse, isImageResponse, isLiveResponse, isTextResponse, isToolCallResponse, isTranscriptionResponse, isVideoResponse, requireFunctionToolCalls, resolveFixtureBlocks, resolveRequestId, resolveResponsesBlocks, strictNoMatchLogLine, strictNoMatchMessage } from "./helpers.js";
 import { InterruptionControl, createInterruptionSignal } from "./interruption.js";
 import { ErrorResponseOptions, StreamOptions, calculateDelay, delay, writeErrorResponse, writeSSEStream } from "./sse-writer.js";
 import { ChaosAsyncOutcome, applyChaosAsync, applyChaosDeprecated, evaluateChaos, resolveChaosLatencyMs } from "./chaos.js";
@@ -58,7 +64,8 @@ import { proxyAndRecord } from "./recorder.js";
 import { resolveUpstreamUrl } from "./url.js";
 import { CollapseResult, MAX_COLLAPSE_STRING_LENGTH, collapseAnthropicSSE, collapseBedrockEventStream, collapseCohereSSE, collapseGeminiInteractionsSSE, collapseGeminiSSE, collapseOllamaNDJSON, collapseOpenAISSE, collapseStreamingResponse, setCollapseStringLimitForTests } from "./stream-collapse.js";
 import { MCPMock } from "./mcp-mock.js";
+import { AimockFakesReportError, AimockTestIdCollisionError, McpFakesReport, assertFakesReport } from "./mcp-fakes-report.js";
 import { VectorMock } from "./vector-mock.js";
 import { JsonRpcDispatcherOptions, JsonRpcResponse, MethodHandler, createJsonRpcDispatcher } from "./jsonrpc.js";
 import { MockSuite, MockSuiteOptions, createMockSuite } from "./suite.js";
-export { type A2AAgentDefinition, type A2AArtifact, type A2AMessage, A2AMock, type A2AMockOptions, type A2APart, type A2ARole, type A2AStreamEvent, type A2ATask, type A2ATaskResponse, type A2ATaskState, type AGUIActivityDeltaEvent, type AGUIActivitySnapshotEvent, type AGUIBaseEvent, type AGUIBuildOpts, type AGUICustomEvent, type AGUIEvent, type AGUIEventType, type AGUIFixture, type AGUIFixtureMatch, type AGUIInterrupt, type AGUIMessage, type AGUIMessageContentPart, type AGUIMessageRole, type AGUIMessagesSnapshotEvent, AGUIMock, type AGUIMockOptions, type AGUIRawEvent, type AGUIReasoningEncryptedValueEvent, type AGUIReasoningEncryptedValueSubtype, type AGUIReasoningEndEvent, type AGUIReasoningMessageChunkEvent, type AGUIReasoningMessageContentEvent, type AGUIReasoningMessageEndEvent, type AGUIReasoningMessageStartEvent, type AGUIReasoningStartEvent, type AGUIRecordConfig, type AGUIResumeEntry, type AGUIRunAgentInput, type AGUIRunErrorEvent, type AGUIRunFinishedEvent, type AGUIRunFinishedOutcome, type AGUIRunStartedEvent, type AGUIStateDeltaEvent, type AGUIStateSnapshotEvent, type AGUIStepFinishedEvent, type AGUIStepStartedEvent, type AGUISubagentErrorEvent, type AGUISubagentFinishedEvent, type AGUISubagentFinishedOutcome, type AGUISubagentStartedEvent, type AGUITextMessageChunkEvent, type AGUITextMessageContentEvent, type AGUITextMessageEndEvent, type AGUITextMessageRole, type AGUITextMessageStartEvent, type AGUIThinkingEndEvent, type AGUIThinkingStartEvent, type AGUIThinkingTextMessageContentEvent, type AGUIThinkingTextMessageEndEvent, type AGUIThinkingTextMessageStartEvent, type AGUITokenUsage, type AGUIToolCall, type AGUIToolCallArgsEvent, type AGUIToolCallChunkEvent, type AGUIToolCallEndEvent, type AGUIToolCallResultEvent, type AGUIToolCallStartEvent, type AGUIToolDefinition, AGUI_RECORD_BUFFER_HARD_CEILING, type AimockConfig, type ApiKeyAuthConfig, type AudioResponse, BYTEPLUS_VIDEO_MAX_ENTRIES, BYTEPLUS_VIDEO_TASKS_PATH, type BatchObject, BytePlusVideoJobMap, type ChaosAction, type ChaosAsyncOutcome, type ChaosConfig, type ChatCompletion, type ChatCompletionChoice, type ChatCompletionMessage, type ChatCompletionRequest, type ChatMessage, type CollapseResult, type ContentPart, type ContentWithToolCallsResponse, DEFAULT_AGUI_RECORD_BUFFER_BYTES, DEFAULT_TEST_ID, type EmbeddingAPIResponse, type EmbeddingFixtureOpts, type EmbeddingResponse, type ErrorResponse, type ErrorResponseOptions, FORMAT_TO_CONTENT_TYPE, FalQueueStateMap, type FileObject, type FineTuningJob, type FineTuningJobError, type FineTuningJobEvent, type FineTuningJobHyperparameters, type FineTuningJobStatus, type Fixture, type FixtureBlock, type FixtureFile, type FixtureFileContentWithToolCallsResponse, type FixtureFileEntry, type FixtureFileResponse, type FixtureFileTextResponse, type FixtureFileToolCall, type FixtureFileToolCallResponse, type FixtureMatch, type FixtureOpts, type FixtureResponse, GROK_VIDEO_MAX_ENTRIES, GrokVideoJobMap, type ImageItem, type ImageResponse, type InterruptionControl, Journal, type JournalBody, type JournalEntry, type JsonRpcDispatcherOptions, type JsonRpcResponse, LLMock, type LiveBinding, type LiveEntry, type LiveFailureCategory, type LiveFixtureResponse, type LiveJson, type LiveMode, type LiveObject, type LiveOptions, type LivePosition, type LiveTranscript, type LogLevel, Logger, MAX_COLLAPSE_STRING_LENGTH, type MCPContent, MCPMock, type MCPMockOptions, type MCPPromptDefinition, type MCPPromptResult, type MCPResourceContent, type MCPResourceDefinition, type MCPSession, type MCPToolDefinition, type MatchFixtureDiagnostic, type MethodHandler, type MetricsRegistry, type MockServerOptions, type MockSuite, type MockSuiteOptions, type ModerationFixture, type ModerationResult, type Mountable, type NDJSONStreamOptions, OPENROUTER_VIDEO_DEFAULT_MAX_CONTENT_BYTES, OPENROUTER_VIDEO_MAX_ENTRIES, OpenRouterVideoJobMap, type QueryHandler, type QueryResult, type RawJSONResponse, type RecordConfig, type RecordProviderKey, type RerankFixture, type RerankResult, type ResponseOverrides, type ResponsesSSEEvent, type SSEChoice, type SSEChunk, type SSEDelta, type SSEToolCallDelta, type SearchFixture, type SearchResult, type ServerInstance, type ServiceFixtures, type StreamOptions, type StreamingProfile, type TextResponse, type ToolCall, type ToolCallMessage, type ToolCallResponse, type ToolDefinition, type TranscriptionResponse, VEO_VIDEO_MAX_ENTRIES, type ValidationRef, type ValidationResult, type VectorCollection, type VectorEntry, VectorMock, type VectorMockOptions, type VectorQuery, VeoVideoJobMap, type VideoResponse, VideoStateMap, type VoiceDesignPreview, type VoiceDesignResponse, WebSocketConnection, type WebSocketLimits, applyChaosDeprecated as applyChaos, applyChaosAsync, bedrockToCompletionRequest, buildActivityDelta as buildAGUIActivityDelta, buildActivityResponse as buildAGUIActivityResponse, buildCompositeResponse as buildAGUICompositeResponse, buildCustomEvent as buildAGUICustomEvent, buildErrorResponse as buildAGUIErrorResponse, buildMessagesSnapshot as buildAGUIMessagesSnapshot, buildRawEvent as buildAGUIRawEvent, buildReasoningChunk as buildAGUIReasoningChunk, buildReasoningEncryptedValue as buildAGUIReasoningEncryptedValue, buildReasoningResponse as buildAGUIReasoningResponse, buildStateDelta as buildAGUIStateDelta, buildStateUpdate as buildAGUIStateUpdate, buildStepWithText as buildAGUIStepWithText, buildTextChunkResponse as buildAGUITextChunkResponse, buildTextResponse as buildAGUITextResponse, buildToolCallChunk as buildAGUIToolCallChunk, buildToolCallResponse as buildAGUIToolCallResponse, buildBytePlusMatchText, buildContentWithToolCallsChunks, buildContentWithToolCallsCompletion, buildContentWithToolCallsStreamEvents, buildEmbeddingResponse, buildTextChunks, buildTextCompletion, buildTextStreamEvents, buildToolCallChunks, buildToolCallCompletion, buildToolCallStreamEvents, calculateDelay, clearBatchStore, clearElevenLabsVoices, clearFileStore, clearFineTuningStore, cohereToCompletionRequest, collapseAnthropicSSE, collapseBedrockEventStream, collapseCohereSSE, collapseGeminiInteractionsSSE, collapseGeminiSSE, collapseOllamaNDJSON, collapseOpenAISSE, collapseStreamingResponse, computeAcceptKey, converseToCompletionRequest, createInterruptionSignal, createJsonRpcDispatcher, createMetricsRegistry, createMockSuite, createServer, delay, encodeEventStreamFrame, encodeEventStreamMessage, evaluateChaos, extractLastUserMessage as extractAGUILastUserMessage, extractOverrides, findFixture as findAGUIFixture, flattenHeaders, formatToMime, geminiInteractionsToCompletionRequest, generateDeterministicEmbedding, generateId, generateMessageId, generateToolCallId, generateToolUseId, getLastMessageIfToolResult as getAGUILastMessageIfToolResult, getTextContent, handleBatchesCancel, handleBatchesCreate, handleBatchesList, handleBatchesRetrieve, handleBedrock, handleBedrockStream, handleBytePlusVideoCreate, handleBytePlusVideoStatus, handleCohere, handleConverse, handleConverseStream, handleElevenLabsAudio, handleElevenLabsVoiceCreate, handleElevenLabsVoiceDelete, handleElevenLabsVoiceDesign, handleElevenLabsVoiceGet, handleEmbeddings, handleFal, handleFalQueue, handleFilesContent, handleFilesCreate, handleFilesDelete, handleFilesList, handleFilesRetrieve, handleFineTuningCancel, handleFineTuningCreate, handleFineTuningEvents, handleFineTuningList, handleFineTuningRetrieve, handleGemini, handleGeminiInteractions, handleGrokVideoCreate, handleGrokVideoStatus, handleImages, handleMessages, handleModeration, handleOllama, handleOllamaGenerate, handleOpenRouterVideoContent, handleOpenRouterVideoCreate, handleOpenRouterVideoModels, handleOpenRouterVideoStatus, handleRerank, handleResponses, handleSearch, handleSpeech, handleTranscription, handleVeoVideoCreate, handleVeoVideoStatus, handleVideoCreate, handleVideoStatus, handleWebSocketGeminiLive, handleWebSocketRealtime, handleWebSocketResponses, isAudioResponse, isChatCompletionBody, isContentWithToolCallsResponse, isEmbeddingResponse, isErrorResponse, isImageResponse, isLiveResponse, isTextResponse, isToolCallResponse, isTranscriptionResponse, isVideoResponse, loadConfig, loadFixtureFile, loadFixturesFromDir, matchFixture, matchFixtureDiagnostic, matchesFixture as matchesAGUIFixture, normalizePathLabel, normalizeResponse, ollamaToCompletionRequest, proxyAndRecord, proxyAndRecordAGUI, renderValidationRef, resolveChaosLatencyMs, resolveFixtureBlocks, resolveRequestId, resolveUpstreamUrl, setAGUIRecordBufferCeilingForTests, setCollapseStringLimitForTests, startFromConfig, strictNoMatchLogLine, strictNoMatchMessage, upgradeToWebSocket, validateFixtures, voiceDesignToJson, writeAGUIEventStream, writeErrorResponse, writeEventStream, writeNDJSONStream, writeSSEStream };
+export { type A2AAgentDefinition, type A2AArtifact, type A2AMessage, A2AMock, type A2AMockOptions, type A2APart, type A2ARole, type A2AStreamEvent, type A2ATask, type A2ATaskResponse, type A2ATaskState, type AGUIActivityDeltaEvent, type AGUIActivitySnapshotEvent, type AGUIBaseEvent, type AGUIBuildOpts, type AGUICustomEvent, type AGUIEvent, type AGUIEventType, type AGUIFixture, type AGUIFixtureMatch, type AGUIInterrupt, type AGUIMessage, type AGUIMessageContentPart, type AGUIMessageRole, type AGUIMessagesSnapshotEvent, AGUIMock, type AGUIMockOptions, type AGUIRawEvent, type AGUIReasoningEncryptedValueEvent, type AGUIReasoningEncryptedValueSubtype, type AGUIReasoningEndEvent, type AGUIReasoningMessageChunkEvent, type AGUIReasoningMessageContentEvent, type AGUIReasoningMessageEndEvent, type AGUIReasoningMessageStartEvent, type AGUIReasoningStartEvent, type AGUIRecordConfig, type AGUIResumeEntry, type AGUIRunAgentInput, type AGUIRunErrorEvent, type AGUIRunFinishedEvent, type AGUIRunFinishedOutcome, type AGUIRunStartedEvent, type AGUIStateDeltaEvent, type AGUIStateSnapshotEvent, type AGUIStepFinishedEvent, type AGUIStepStartedEvent, type AGUISubagentErrorEvent, type AGUISubagentFinishedEvent, type AGUISubagentFinishedOutcome, type AGUISubagentStartedEvent, type AGUITextMessageChunkEvent, type AGUITextMessageContentEvent, type AGUITextMessageEndEvent, type AGUITextMessageRole, type AGUITextMessageStartEvent, type AGUIThinkingEndEvent, type AGUIThinkingStartEvent, type AGUIThinkingTextMessageContentEvent, type AGUIThinkingTextMessageEndEvent, type AGUIThinkingTextMessageStartEvent, type AGUITokenUsage, type AGUIToolCall, type AGUIToolCallArgsEvent, type AGUIToolCallChunkEvent, type AGUIToolCallEndEvent, type AGUIToolCallResultEvent, type AGUIToolCallStartEvent, type AGUIToolDefinition, AGUI_RECORD_BUFFER_HARD_CEILING, type AimockConfig, AimockFakesReportError, AimockTestIdCollisionError, type ApiKeyAuthConfig, type AudioResponse, BYTEPLUS_VIDEO_MAX_ENTRIES, BYTEPLUS_VIDEO_TASKS_PATH, type BatchObject, BytePlusVideoJobMap, CATALOG_ROUTES, type CatalogRoute, type ChaosAction, type ChaosAsyncOutcome, type ChaosConfig, type ChatCompletion, type ChatCompletionChoice, type ChatCompletionMessage, type ChatCompletionRequest, type ChatMessage, type CollapseResult, type ContentPart, type ContentWithToolCallsResponse, type CustomToolCall, type CustomToolCallMessage, type CustomToolDefinition, DEFAULT_AGUI_RECORD_BUFFER_BYTES, DEFAULT_TEST_ID, type EmbeddingAPIResponse, type EmbeddingFixtureOpts, type EmbeddingResponse, type ErrorResponse, type ErrorResponseOptions, FORMAT_TO_CONTENT_TYPE, FalQueueStateMap, type FileObject, type FineTuningJob, type FineTuningJobError, type FineTuningJobEvent, type FineTuningJobHyperparameters, type FineTuningJobStatus, type Fixture, type FixtureBlock, type FixtureFile, type FixtureFileContentWithToolCallsResponse, type FixtureFileCustomToolCall, type FixtureFileEntry, type FixtureFileResponse, type FixtureFileResponsesBlock, type FixtureFileTextResponse, type FixtureFileToolCall, type FixtureFileToolCallResponse, FixtureLoadError, type FixtureLoadErrorJSON, type FixtureMatch, type FixtureOpts, type FixtureResponse, type FixtureToolCall, type FixturesWithServices, type FunctionFixtureBlock, GROK_VIDEO_MAX_ENTRIES, GrokVideoJobMap, type ImageItem, type ImageResponse, type InterruptionControl, InvalidFixtureToolCallError, Journal, type JournalBody, type JournalEntry, type JsonRpcDispatcherOptions, type JsonRpcResponse, LLMock, type LiveBinding, type LiveEntry, type LiveFailureCategory, type LiveFixtureResponse, type LiveJson, type LiveMode, type LiveObject, type LiveOptions, type LivePosition, type LiveTranscript, type LogLevel, Logger, MAX_COLLAPSE_STRING_LENGTH, type MCPContent, MCPMock, type MCPMockOptions, type MCPPromptDefinition, type MCPPromptResult, type MCPResourceContent, type MCPResourceDefinition, type MCPSession, type MCPToolDefinition, MCP_FAKE_ERROR_CODES, type MatchFixtureDiagnostic, type McpFakeAddOrigin, type McpFakeAddResult, type McpFakeAnnotations, type McpFakeBlock, type McpFakeBlockSnapshot, type McpFakeCall, type McpFakeCallAnswer, type McpFakeCallMatch, type McpFakeContentBlock, type McpFakeDeclaredEntry, type McpFakeDeepReadonly, type McpFakeErrorCode, type McpFakeFullResult, type McpFakeIcon, type McpFakeIdentity, type McpFakeIssue, type McpFakeNotification, type McpFakeOutcome, type McpFakeRecorded, type McpFakeReportEvent, type McpFakeReportPart, type McpFakeResourceContents, type McpFakeResult, type McpFakeScope, type McpFakeSource, type McpFakeStructuredResult, type McpFakeTool, type McpFakeUndeclaredPolicy, McpFakesAddError, type McpFakesAddErrorJSON, type McpFakesReport, type McpRecordConfig, type MethodHandler, type MetricsRegistry, type MisbehaviorConfig, MisbehaviorConfigError, type MisbehaviorConfigErrorJSON, type MisbehaviorFault, type MisbehaviorFaultId, type MisbehaviorRule, type MockServerOptions, type MockSuite, type MockSuiteOptions, type ModerationFixture, type ModerationResult, type Mountable, type NDJSONStreamOptions, OPENROUTER_VIDEO_DEFAULT_MAX_CONTENT_BYTES, OPENROUTER_VIDEO_MAX_ENTRIES, OpenRouterVideoJobMap, type QueryHandler, type QueryResult, ROUTE_DEFINITIONS, type RawJSONResponse, type RecordConfig, type RecordProviderKey, type RecordReplayLoadRule, type RerankFixture, type RerankResult, type ResponseOverrides, type ResponsesFixtureBlock, type ResponsesSSEEvent, type ResponsesToolsMode, type RouteDefinition, type SSEChoice, type SSEChunk, type SSEDelta, type SSEToolCallDelta, type SearchFixture, type SearchResult, type ServerInstance, type ServiceFixtures, type StreamOptions, type StreamingProfile, type TextResponse, type ToolCall, type ToolCallMessage, type ToolCallResponse, type ToolDefinition, type TranscriptionResponse, UnsupportedToolCallError, VEO_VIDEO_MAX_ENTRIES, type ValidationRef, type ValidationResult, type VectorCollection, type VectorEntry, type VectorFileBatchObject, type VectorFileBatchStatus, VectorMock, type VectorMockOptions, type VectorQuery, type VectorSearchResult, type VectorStoreFileObject, type VectorStoreFileStatus, type VectorStoreObject, type VectorStoreStatus, VeoVideoJobMap, type VideoResponse, VideoStateMap, type VoiceDesignPreview, type VoiceDesignResponse, WebSocketConnection, type WebSocketLimits, applyChaosDeprecated as applyChaos, applyChaosAsync, assertFakesReport, bedrockToCompletionRequest, buildActivityDelta as buildAGUIActivityDelta, buildActivityResponse as buildAGUIActivityResponse, buildCompositeResponse as buildAGUICompositeResponse, buildCustomEvent as buildAGUICustomEvent, buildErrorResponse as buildAGUIErrorResponse, buildMessagesSnapshot as buildAGUIMessagesSnapshot, buildRawEvent as buildAGUIRawEvent, buildReasoningChunk as buildAGUIReasoningChunk, buildReasoningEncryptedValue as buildAGUIReasoningEncryptedValue, buildReasoningResponse as buildAGUIReasoningResponse, buildStateDelta as buildAGUIStateDelta, buildStateUpdate as buildAGUIStateUpdate, buildStepWithText as buildAGUIStepWithText, buildTextChunkResponse as buildAGUITextChunkResponse, buildTextResponse as buildAGUITextResponse, buildToolCallChunk as buildAGUIToolCallChunk, buildToolCallResponse as buildAGUIToolCallResponse, buildBytePlusMatchText, buildContentWithToolCallsChunks, buildContentWithToolCallsCompletion, buildContentWithToolCallsStreamEvents, buildEmbeddingResponse, buildOpenApiDocument, buildTextChunks, buildTextCompletion, buildTextStreamEvents, buildToolCallChunks, buildToolCallCompletion, buildToolCallStreamEvents, calculateDelay, clearBatchStore, clearElevenLabsVoices, clearFileStore, clearFineTuningStore, clearVectorStoreStore, cohereToCompletionRequest, collapseAnthropicSSE, collapseBedrockEventStream, collapseCohereSSE, collapseGeminiInteractionsSSE, collapseGeminiSSE, collapseOllamaNDJSON, collapseOpenAISSE, collapseStreamingResponse, computeAcceptKey, converseToCompletionRequest, createInterruptionSignal, createJsonRpcDispatcher, createMetricsRegistry, createMockSuite, createServer, delay, encodeEventStreamFrame, encodeEventStreamMessage, evaluateChaos, extractLastUserMessage as extractAGUILastUserMessage, extractOverrides, findFixture as findAGUIFixture, flattenHeaders, formatToMime, geminiInteractionsToCompletionRequest, generateDeterministicEmbedding, generateId, generateMessageId, generateToolCallId, generateToolUseId, getLastMessageIfToolResult as getAGUILastMessageIfToolResult, getTextContent, handleBatchesCancel, handleBatchesCreate, handleBatchesList, handleBatchesRetrieve, handleBedrock, handleBedrockStream, handleBytePlusVideoCreate, handleBytePlusVideoStatus, handleCohere, handleConverse, handleConverseStream, handleElevenLabsAudio, handleElevenLabsVoiceCreate, handleElevenLabsVoiceDelete, handleElevenLabsVoiceDesign, handleElevenLabsVoiceGet, handleEmbeddings, handleFal, handleFalQueue, handleFilesContent, handleFilesCreate, handleFilesDelete, handleFilesList, handleFilesRetrieve, handleFineTuningCancel, handleFineTuningCreate, handleFineTuningEvents, handleFineTuningList, handleFineTuningRetrieve, handleGemini, handleGeminiInteractions, handleGrokVideoCreate, handleGrokVideoStatus, handleImages, handleMessages, handleModeration, handleOllama, handleOllamaGenerate, handleOpenRouterVideoContent, handleOpenRouterVideoCreate, handleOpenRouterVideoModels, handleOpenRouterVideoStatus, handleRerank, handleResponses, handleSearch, handleSpeech, handleTranscription, handleVectorFileBatchesCancel, handleVectorFileBatchesCreate, handleVectorFileBatchesFiles, handleVectorFileBatchesRetrieve, handleVectorStoreFilesCreate, handleVectorStoreFilesDelete, handleVectorStoreFilesList, handleVectorStoreFilesRetrieve, handleVectorStoresCreate, handleVectorStoresDelete, handleVectorStoresList, handleVectorStoresModify, handleVectorStoresRetrieve, handleVectorStoresSearch, handleVeoVideoCreate, handleVeoVideoStatus, handleVideoCreate, handleVideoStatus, handleWebSocketGeminiLive, handleWebSocketRealtime, handleWebSocketResponses, isAudioResponse, isChatCompletionBody, isContentWithToolCallsResponse, isEmbeddingResponse, isErrorResponse, isImageResponse, isLiveResponse, isTextResponse, isToolCallResponse, isTranscriptionResponse, isVideoResponse, loadConfig, loadFixtureFile, loadFixtureFileWithServices, loadFixturesFromDir, loadFixturesFromDirWithServices, matchFixture, matchFixtureDiagnostic, matchesFixture as matchesAGUIFixture, normalizePathLabel, normalizeResponse, ollamaToCompletionRequest, proxyAndRecord, proxyAndRecordAGUI, renderValidationRef, requireFunctionToolCalls, resolveChaosLatencyMs, resolveFixtureBlocks, resolveRequestId, resolveResponsesBlocks, resolveUpstreamUrl, setAGUIRecordBufferCeilingForTests, setCollapseStringLimitForTests, startFromConfig, strictNoMatchLogLine, strictNoMatchMessage, upgradeToWebSocket, validateFixtures, voiceDesignToJson, writeAGUIEventStream, writeErrorResponse, writeEventStream, writeNDJSONStream, writeSSEStream };

package/dist/index.js

@@ -1,11 +1,11 @@
 import { DEFAULT_TEST_ID } from "./constants.js";
-import { FORMAT_TO_CONTENT_TYPE, buildContentWithToolCallsChunks, buildContentWithToolCallsCompletion, buildEmbeddingResponse, buildTextChunks, buildTextCompletion, buildToolCallChunks, buildToolCallCompletion, extractOverrides, flattenHeaders, formatToMime, generateDeterministicEmbedding, generateId, generateMessageId, generateToolCallId, generateToolUseId, isAudioResponse, isContentWithToolCallsResponse, isEmbeddingResponse, isErrorResponse, isImageResponse, isLiveResponse, isTextResponse, isToolCallResponse, isTranscriptionResponse, isVideoResponse, resolveFixtureBlocks, resolveRequestId, strictNoMatchLogLine, strictNoMatchMessage } from "./helpers.js";
+import { FORMAT_TO_CONTENT_TYPE, InvalidFixtureToolCallError, UnsupportedToolCallError, buildContentWithToolCallsChunks, buildContentWithToolCallsCompletion, buildEmbeddingResponse, buildTextChunks, buildTextCompletion, buildToolCallChunks, buildToolCallCompletion, extractOverrides, flattenHeaders, formatToMime, generateDeterministicEmbedding, generateId, generateMessageId, generateToolCallId, generateToolUseId, isAudioResponse, isContentWithToolCallsResponse, isEmbeddingResponse, isErrorResponse, isImageResponse, isLiveResponse, isTextResponse, isToolCallResponse, isTranscriptionResponse, isVideoResponse, requireFunctionToolCalls, resolveFixtureBlocks, resolveRequestId, resolveResponsesBlocks, strictNoMatchLogLine, strictNoMatchMessage } from "./helpers.js";
 import { createJsonRpcDispatcher } from "./jsonrpc.js";
 import { A2AMock } from "./a2a-mock.js";
 import { buildActivityDelta, buildActivityResponse, buildCompositeResponse, buildCustomEvent, buildErrorResponse, buildMessagesSnapshot, buildRawEvent, buildReasoningChunk, buildReasoningEncryptedValue, buildReasoningResponse, buildStateDelta, buildStateUpdate, buildStepWithText, buildTextChunkResponse, buildTextResponse, buildToolCallChunk, buildToolCallResponse, extractLastUserMessage, findFixture, getLastMessageIfToolResult, matchesFixture, writeAGUIEventStream } from "./agui-handler.js";
 import { calculateDelay, delay, writeErrorResponse, writeSSEStream } from "./sse-writer.js";
 import { applyChaosAsync, applyChaosDeprecated, evaluateChaos, resolveChaosLatencyMs } from "./chaos.js";
-import { loadFixtureFile, loadFixturesFromDir, normalizeResponse, renderValidationRef, validateFixtures } from "./fixture-loader.js";
+import { FixtureLoadError, MisbehaviorConfigError, loadFixtureFile, loadFixturesFromDir, normalizeResponse, renderValidationRef, validateFixtures } from "./fixture-loader.js";
 import { getTextContent, matchFixture, matchFixtureDiagnostic } from "./router.js";
 import { MAX_COLLAPSE_STRING_LENGTH, collapseAnthropicSSE, collapseBedrockEventStream, collapseCohereSSE, collapseGeminiInteractionsSSE, collapseGeminiSSE, collapseOllamaNDJSON, collapseOpenAISSE, collapseStreamingResponse, setCollapseStringLimitForTests } from "./stream-collapse.js";
 import { resolveUpstreamUrl } from "./url.js";
@@ -42,18 +42,25 @@ import { handleSearch } from "./search.js";
 import { handleRerank } from "./rerank.js";
 import { handleModeration } from "./moderation.js";
 import { clearFineTuningStore, handleFineTuningCancel, handleFineTuningCreate, handleFineTuningEvents, handleFineTuningList, handleFineTuningRetrieve } from "./fine-tuning.js";
+import { clearVectorStoreStore, handleVectorFileBatchesCancel, handleVectorFileBatchesCreate, handleVectorFileBatchesFiles, handleVectorFileBatchesRetrieve, handleVectorStoreFilesCreate, handleVectorStoreFilesDelete, handleVectorStoreFilesList, handleVectorStoreFilesRetrieve, handleVectorStoresCreate, handleVectorStoresDelete, handleVectorStoresList, handleVectorStoresModify, handleVectorStoresRetrieve, handleVectorStoresSearch } from "./vector-stores.js";
 import { clearFileStore, handleFilesContent, handleFilesCreate, handleFilesDelete, handleFilesList, handleFilesRetrieve } from "./files.js";
 import { clearBatchStore, handleBatchesCancel, handleBatchesCreate, handleBatchesList, handleBatchesRetrieve } from "./batches.js";
 import { WebSocketConnection, computeAcceptKey, upgradeToWebSocket } from "./ws-framing.js";
 import { handleWebSocketResponses } from "./ws-responses.js";
 import { handleWebSocketRealtime } from "./ws-realtime.js";
 import { handleWebSocketGeminiLive } from "./ws-gemini-live.js";
+import { ROUTE_DEFINITIONS } from "./route-registry.js";
+import { CATALOG_ROUTES, buildOpenApiDocument } from "./openapi.js";
 import { createMetricsRegistry, normalizePathLabel } from "./metrics.js";
+import { MCP_FAKE_ERROR_CODES } from "./types.js";
+import { McpFakesAddError } from "./mcp-fakes.js";
+import { MCPMock } from "./mcp-mock.js";
+import { AimockFakesReportError, AimockTestIdCollisionError, assertFakesReport } from "./mcp-fakes-report.js";
 import { createServer } from "./server.js";
+import { loadFixtureFileWithServices, loadFixturesFromDirWithServices } from "./fixture-loader-services.js";
 import { LLMock } from "./llmock.js";
-import { MCPMock } from "./mcp-mock.js";
 import { VectorMock } from "./vector-mock.js";
 import { loadConfig, startFromConfig } from "./config-loader.js";
 import { createMockSuite } from "./suite.js";
 
-export { A2AMock, AGUIMock, AGUI_RECORD_BUFFER_HARD_CEILING, BYTEPLUS_VIDEO_MAX_ENTRIES, BYTEPLUS_VIDEO_TASKS_PATH, BytePlusVideoJobMap, DEFAULT_AGUI_RECORD_BUFFER_BYTES, DEFAULT_TEST_ID, FORMAT_TO_CONTENT_TYPE, FalQueueStateMap, GROK_VIDEO_MAX_ENTRIES, GrokVideoJobMap, Journal, LLMock, Logger, MAX_COLLAPSE_STRING_LENGTH, MCPMock, OPENROUTER_VIDEO_DEFAULT_MAX_CONTENT_BYTES, OPENROUTER_VIDEO_MAX_ENTRIES, OpenRouterVideoJobMap, VEO_VIDEO_MAX_ENTRIES, VectorMock, VeoVideoJobMap, VideoStateMap, WebSocketConnection, applyChaosDeprecated as applyChaos, applyChaosAsync, bedrockToCompletionRequest, buildActivityDelta as buildAGUIActivityDelta, buildActivityResponse as buildAGUIActivityResponse, buildCompositeResponse as buildAGUICompositeResponse, buildCustomEvent as buildAGUICustomEvent, buildErrorResponse as buildAGUIErrorResponse, buildMessagesSnapshot as buildAGUIMessagesSnapshot, buildRawEvent as buildAGUIRawEvent, buildReasoningChunk as buildAGUIReasoningChunk, buildReasoningEncryptedValue as buildAGUIReasoningEncryptedValue, buildReasoningResponse as buildAGUIReasoningResponse, buildStateDelta as buildAGUIStateDelta, buildStateUpdate as buildAGUIStateUpdate, buildStepWithText as buildAGUIStepWithText, buildTextChunkResponse as buildAGUITextChunkResponse, buildTextResponse as buildAGUITextResponse, buildToolCallChunk as buildAGUIToolCallChunk, buildToolCallResponse as buildAGUIToolCallResponse, buildBytePlusMatchText, buildContentWithToolCallsChunks, buildContentWithToolCallsCompletion, buildContentWithToolCallsStreamEvents, buildEmbeddingResponse, buildTextChunks, buildTextCompletion, buildTextStreamEvents, buildToolCallChunks, buildToolCallCompletion, buildToolCallStreamEvents, calculateDelay, clearBatchStore, clearElevenLabsVoices, clearFileStore, clearFineTuningStore, cohereToCompletionRequest, collapseAnthropicSSE, collapseBedrockEventStream, collapseCohereSSE, collapseGeminiInteractionsSSE, collapseGeminiSSE, collapseOllamaNDJSON, collapseOpenAISSE, collapseStreamingResponse, computeAcceptKey, converseToCompletionRequest, createInterruptionSignal, createJsonRpcDispatcher, createMetricsRegistry, createMockSuite, createServer, delay, encodeEventStreamFrame, encodeEventStreamMessage, evaluateChaos, extractLastUserMessage as extractAGUILastUserMessage, extractOverrides, findFixture as findAGUIFixture, flattenHeaders, formatToMime, geminiInteractionsToCompletionRequest, generateDeterministicEmbedding, generateId, generateMessageId, generateToolCallId, generateToolUseId, getLastMessageIfToolResult as getAGUILastMessageIfToolResult, getTextContent, handleBatchesCancel, handleBatchesCreate, handleBatchesList, handleBatchesRetrieve, handleBedrock, handleBedrockStream, handleBytePlusVideoCreate, handleBytePlusVideoStatus, handleCohere, handleConverse, handleConverseStream, handleElevenLabsAudio, handleElevenLabsVoiceCreate, handleElevenLabsVoiceDelete, handleElevenLabsVoiceDesign, handleElevenLabsVoiceGet, handleEmbeddings, handleFal, handleFalQueue, handleFilesContent, handleFilesCreate, handleFilesDelete, handleFilesList, handleFilesRetrieve, handleFineTuningCancel, handleFineTuningCreate, handleFineTuningEvents, handleFineTuningList, handleFineTuningRetrieve, handleGemini, handleGeminiInteractions, handleGrokVideoCreate, handleGrokVideoStatus, handleImages, handleMessages, handleModeration, handleOllama, handleOllamaGenerate, handleOpenRouterVideoContent, handleOpenRouterVideoCreate, handleOpenRouterVideoModels, handleOpenRouterVideoStatus, handleRerank, handleResponses, handleSearch, handleSpeech, handleTranscription, handleVeoVideoCreate, handleVeoVideoStatus, handleVideoCreate, handleVideoStatus, handleWebSocketGeminiLive, handleWebSocketRealtime, handleWebSocketResponses, isAudioResponse, isChatCompletionBody, isContentWithToolCallsResponse, isEmbeddingResponse, isErrorResponse, isImageResponse, isLiveResponse, isTextResponse, isToolCallResponse, isTranscriptionResponse, isVideoResponse, loadConfig, loadFixtureFile, loadFixturesFromDir, matchFixture, matchFixtureDiagnostic, matchesFixture as matchesAGUIFixture, normalizePathLabel, normalizeResponse, ollamaToCompletionRequest, proxyAndRecord, proxyAndRecordAGUI, renderValidationRef, resolveChaosLatencyMs, resolveFixtureBlocks, resolveRequestId, resolveUpstreamUrl, setAGUIRecordBufferCeilingForTests, setCollapseStringLimitForTests, startFromConfig, strictNoMatchLogLine, strictNoMatchMessage, upgradeToWebSocket, validateFixtures, voiceDesignToJson, writeAGUIEventStream, writeErrorResponse, writeEventStream, writeNDJSONStream, writeSSEStream };
+export { A2AMock, AGUIMock, AGUI_RECORD_BUFFER_HARD_CEILING, AimockFakesReportError, AimockTestIdCollisionError, BYTEPLUS_VIDEO_MAX_ENTRIES, BYTEPLUS_VIDEO_TASKS_PATH, BytePlusVideoJobMap, CATALOG_ROUTES, DEFAULT_AGUI_RECORD_BUFFER_BYTES, DEFAULT_TEST_ID, FORMAT_TO_CONTENT_TYPE, FalQueueStateMap, FixtureLoadError, GROK_VIDEO_MAX_ENTRIES, GrokVideoJobMap, InvalidFixtureToolCallError, Journal, LLMock, Logger, MAX_COLLAPSE_STRING_LENGTH, MCPMock, MCP_FAKE_ERROR_CODES, McpFakesAddError, MisbehaviorConfigError, OPENROUTER_VIDEO_DEFAULT_MAX_CONTENT_BYTES, OPENROUTER_VIDEO_MAX_ENTRIES, OpenRouterVideoJobMap, ROUTE_DEFINITIONS, UnsupportedToolCallError, VEO_VIDEO_MAX_ENTRIES, VectorMock, VeoVideoJobMap, VideoStateMap, WebSocketConnection, applyChaosDeprecated as applyChaos, applyChaosAsync, assertFakesReport, bedrockToCompletionRequest, buildActivityDelta as buildAGUIActivityDelta, buildActivityResponse as buildAGUIActivityResponse, buildCompositeResponse as buildAGUICompositeResponse, buildCustomEvent as buildAGUICustomEvent, buildErrorResponse as buildAGUIErrorResponse, buildMessagesSnapshot as buildAGUIMessagesSnapshot, buildRawEvent as buildAGUIRawEvent, buildReasoningChunk as buildAGUIReasoningChunk, buildReasoningEncryptedValue as buildAGUIReasoningEncryptedValue, buildReasoningResponse as buildAGUIReasoningResponse, buildStateDelta as buildAGUIStateDelta, buildStateUpdate as buildAGUIStateUpdate, buildStepWithText as buildAGUIStepWithText, buildTextChunkResponse as buildAGUITextChunkResponse, buildTextResponse as buildAGUITextResponse, buildToolCallChunk as buildAGUIToolCallChunk, buildToolCallResponse as buildAGUIToolCallResponse, buildBytePlusMatchText, buildContentWithToolCallsChunks, buildContentWithToolCallsCompletion, buildContentWithToolCallsStreamEvents, buildEmbeddingResponse, buildOpenApiDocument, buildTextChunks, buildTextCompletion, buildTextStreamEvents, buildToolCallChunks, buildToolCallCompletion, buildToolCallStreamEvents, calculateDelay, clearBatchStore, clearElevenLabsVoices, clearFileStore, clearFineTuningStore, clearVectorStoreStore, cohereToCompletionRequest, collapseAnthropicSSE, collapseBedrockEventStream, collapseCohereSSE, collapseGeminiInteractionsSSE, collapseGeminiSSE, collapseOllamaNDJSON, collapseOpenAISSE, collapseStreamingResponse, computeAcceptKey, converseToCompletionRequest, createInterruptionSignal, createJsonRpcDispatcher, createMetricsRegistry, createMockSuite, createServer, delay, encodeEventStreamFrame, encodeEventStreamMessage, evaluateChaos, extractLastUserMessage as extractAGUILastUserMessage, extractOverrides, findFixture as findAGUIFixture, flattenHeaders, formatToMime, geminiInteractionsToCompletionRequest, generateDeterministicEmbedding, generateId, generateMessageId, generateToolCallId, generateToolUseId, getLastMessageIfToolResult as getAGUILastMessageIfToolResult, getTextContent, handleBatchesCancel, handleBatchesCreate, handleBatchesList, handleBatchesRetrieve, handleBedrock, handleBedrockStream, handleBytePlusVideoCreate, handleBytePlusVideoStatus, handleCohere, handleConverse, handleConverseStream, handleElevenLabsAudio, handleElevenLabsVoiceCreate, handleElevenLabsVoiceDelete, handleElevenLabsVoiceDesign, handleElevenLabsVoiceGet, handleEmbeddings, handleFal, handleFalQueue, handleFilesContent, handleFilesCreate, handleFilesDelete, handleFilesList, handleFilesRetrieve, handleFineTuningCancel, handleFineTuningCreate, handleFineTuningEvents, handleFineTuningList, handleFineTuningRetrieve, handleGemini, handleGeminiInteractions, handleGrokVideoCreate, handleGrokVideoStatus, handleImages, handleMessages, handleModeration, handleOllama, handleOllamaGenerate, handleOpenRouterVideoContent, handleOpenRouterVideoCreate, handleOpenRouterVideoModels, handleOpenRouterVideoStatus, handleRerank, handleResponses, handleSearch, handleSpeech, handleTranscription, handleVectorFileBatchesCancel, handleVectorFileBatchesCreate, handleVectorFileBatchesFiles, handleVectorFileBatchesRetrieve, handleVectorStoreFilesCreate, handleVectorStoreFilesDelete, handleVectorStoreFilesList, handleVectorStoreFilesRetrieve, handleVectorStoresCreate, handleVectorStoresDelete, handleVectorStoresList, handleVectorStoresModify, handleVectorStoresRetrieve, handleVectorStoresSearch, handleVeoVideoCreate, handleVeoVideoStatus, handleVideoCreate, handleVideoStatus, handleWebSocketGeminiLive, handleWebSocketRealtime, handleWebSocketResponses, isAudioResponse, isChatCompletionBody, isContentWithToolCallsResponse, isEmbeddingResponse, isErrorResponse, isImageResponse, isLiveResponse, isTextResponse, isToolCallResponse, isTranscriptionResponse, isVideoResponse, loadConfig, loadFixtureFile, loadFixtureFileWithServices, loadFixturesFromDir, loadFixturesFromDirWithServices, matchFixture, matchFixtureDiagnostic, matchesFixture as matchesAGUIFixture, normalizePathLabel, normalizeResponse, ollamaToCompletionRequest, proxyAndRecord, proxyAndRecordAGUI, renderValidationRef, requireFunctionToolCalls, resolveChaosLatencyMs, resolveFixtureBlocks, resolveRequestId, resolveResponsesBlocks, resolveUpstreamUrl, setAGUIRecordBufferCeilingForTests, setCollapseStringLimitForTests, startFromConfig, strictNoMatchLogLine, strictNoMatchMessage, upgradeToWebSocket, validateFixtures, voiceDesignToJson, writeAGUIEventStream, writeErrorResponse, writeEventStream, writeNDJSONStream, writeSSEStream };

package/dist/jest.cjs

@@ -1,17 +1,28 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 const require_runtime = require('./_virtual/_rolldown/runtime.cjs');
 const require_fixture_loader = require('./fixture-loader.cjs');
+const require_mcp_fakes_report = require('./mcp-fakes-report.cjs');
 const require_llmock = require('./llmock.cjs');
+const require_fakes_plugin = require('./fakes-plugin.cjs');
 let node_fs = require("node:fs");
 let node_path = require("node:path");
 
 //#region src/jest.ts
+/** TI2: `<testPath relative to root, with "/"> › <currentTestName>`. */
+function defaultJestId(root) {
+	const { testPath, currentTestName } = expect.getState();
+	if (!testPath || currentTestName === void 0) throw new require_mcp_fakes_report.AimockTestIdCollisionError("default test ids are not supported here (concurrent test or no running test); pass an explicit testId");
+	return (0, node_path.relative)(root, testPath).split(node_path.sep).join("/") + require_fakes_plugin.TEST_ID_SEPARATOR + currentTestName;
+}
 /**
 * Start an aimock server for the duration of the test suite.
 *
-* - `beforeAll`: starts the server and optionally loads fixtures
-* - `beforeEach`: closes Live sessions and resets fixture match counts (not fixtures)
-* - `afterEach`: closes Live sessions owned by this helper's server
+* - `beforeAll`: starts the server and optionally loads fixtures (LLM fixtures and
+*   `mcpFakes` blocks; a bad `mcpFakes` block fails `beforeAll`)
+* - `beforeEach`: closes Live sessions and resets fixture match counts and MCP fake
+*   consumption (not fixtures or fakes)
+* - `afterEach`: closes Live sessions owned by this helper's server, then checks
+*   the MCP fake report under `fakesReport: "warn" | "fail"`
 * - `afterAll`: stops the server
 *
 * Returns a getter function — call it inside tests to access the handle.
@@ -23,13 +34,13 @@ function useAimock(options = {}) {
 	let handle = null;
 	let origOpenaiUrl;
 	let origAnthropicUrl;
+	const root = (0, node_path.resolve)(options.testIdRoot ?? process.cwd());
+	let state = new require_fakes_plugin.FakesPluginState("off");
 	beforeAll(async () => {
-		const { fixtures: fixturePath, patchEnv, ...serverOpts } = options;
+		const { fixtures: fixturePath, patchEnv, fakesReport, testIdRoot, ...serverOpts } = options;
+		state = new require_fakes_plugin.FakesPluginState(require_fakes_plugin.fakesReportMode(fakesReport));
 		const llm = new require_llmock.LLMock(serverOpts);
-		if (fixturePath) {
-			const loadedFixtures = loadFixtures((0, node_path.resolve)(fixturePath), options.live);
-			for (const f of loadedFixtures) llm.addFixture(f);
-		}
+		if (fixturePath) loadFixtures(llm, (0, node_path.resolve)(fixturePath));
 		const url = await llm.start();
 		if (patchEnv !== false) {
 			origOpenaiUrl = process.env.OPENAI_BASE_URL;
@@ -39,17 +50,27 @@ function useAimock(options = {}) {
 		}
 		handle = {
 			llm,
-			url
+			url,
+			fakesFor(testId, opts = {}) {
+				const id = testId ?? defaultJestId(root);
+				state.register(id, opts.context ?? null);
+				return require_fakes_plugin.fakesTarget(url, id, opts);
+			},
+			fakesReport(testId, opts = {}) {
+				return require_fakes_plugin.fetchFakesReport(url, testId ?? defaultJestId(root), opts.context ?? null);
+			}
 		};
 	});
 	beforeEach(() => {
 		if (handle) {
 			handle.llm.closeLiveSessions();
 			handle.llm.resetMatchCounts();
+			state.beforeEach(handle.llm);
 		}
 	});
-	afterEach(() => {
+	afterEach(async () => {
 		handle?.llm.closeLiveSessions();
+		if (handle) await state.afterEach(handle.llm, handle.url);
 	});
 	afterAll(async () => {
 		if (handle) {
@@ -68,13 +89,21 @@ function useAimock(options = {}) {
 		return handle;
 	};
 }
-function loadFixtures(fixturePath, liveOptions) {
+/**
+* Load a fixture file or directory into `llm`: its LLM fixtures and its
+* `mcpFakes` blocks, which the LLMock buffers and auto-mounts at start (F12).
+* A `FixtureLoadError` (a bad `mcpFakes` block) or a `MisbehaviorConfigError`
+* (a bad fixture `misbehavior` key, thrown only with `enableMisbehavior: true`)
+* propagates and fails `beforeAll`; any other load failure is only warned
+* about, as before.
+*/
+function loadFixtures(llm, fixturePath) {
 	try {
-		if ((0, node_fs.statSync)(fixturePath).isDirectory()) return require_fixture_loader.loadFixturesFromDir(fixturePath, void 0, liveOptions);
-		return require_fixture_loader.loadFixtureFile(fixturePath, void 0, liveOptions);
+		if ((0, node_fs.statSync)(fixturePath).isDirectory()) llm.loadFixtureDir(fixturePath);
+		else llm.loadFixtureFile(fixturePath);
 	} catch (err) {
+		if (err instanceof require_fixture_loader.FixtureLoadError || err instanceof require_fixture_loader.MisbehaviorConfigError) throw err;
 		console.warn(`[aimock] Failed to load fixtures from ${fixturePath}: ${err instanceof Error ? err.message : String(err)}`);
-		return [];
 	}
 }
 

package/dist/jest.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"jest.cjs","names":["LLMock","loadFixturesFromDir","loadFixtureFile"],"sources":["../src/jest.ts"],"sourcesContent":["/**\n * Jest integration for aimock.\n *\n * Usage:\n *   import { useAimock } from \"@copilotkit/aimock/jest\";\n *\n *   const mock = useAimock({ fixtures: \"./fixtures\" });\n *\n *   it(\"responds\", async () => {\n *     const res = await fetch(`${mock().url}/v1/chat/completions`, { ... });\n *   });\n */\n\n/* eslint-disable no-var */\n// Jest globals — available at runtime in jest test files\ndeclare var beforeAll: (fn: () => Promise<void> | void, timeout?: number) => void;\ndeclare var afterAll: (fn: () => Promise<void> | void, timeout?: number) => void;\ndeclare var beforeEach: (fn: () => Promise<void> | void, timeout?: number) => void;\ndeclare var afterEach: (fn: () => Promise<void> | void, timeout?: number) => void;\n/* eslint-enable no-var */\n\nimport { LLMock } from \"./llmock.js\";\nimport { loadFixtureFile, loadFixturesFromDir } from \"./fixture-loader.js\";\nimport type { LiveOptions } from \"./live-types.js\";\nimport type { Fixture, MockServerOptions } from \"./types.js\";\nimport { statSync } from \"node:fs\";\nimport { resolve } from \"node:path\";\n\nexport interface UseAimockOptions extends MockServerOptions {\n  /** Path to fixture file or directory. Loaded automatically on start. */\n  fixtures?: string;\n  /** If true, sets process.env.OPENAI_BASE_URL to the mock URL + /v1. */\n  patchEnv?: boolean;\n}\n\nexport interface AimockHandle {\n  /** The LLMock instance. */\n  readonly llm: LLMock;\n  /** The server URL (e.g., http://127.0.0.1:4010). */\n  readonly url: string;\n}\n\n/**\n * Start an aimock server for the duration of the test suite.\n *\n * - `beforeAll`: starts the server and optionally loads fixtures\n * - `beforeEach`: closes Live sessions and resets fixture match counts (not fixtures)\n * - `afterEach`: closes Live sessions owned by this helper's server\n * - `afterAll`: stops the server\n *\n * Returns a getter function — call it inside tests to access the handle.\n *\n * NOTE: Jest globals (beforeAll, afterAll, beforeEach, afterEach) must be available\n * in the test environment. This works with the default jest configuration.\n */\nexport function useAimock(options: UseAimockOptions = {}): () => AimockHandle {\n  let handle: AimockHandle | null = null;\n  let origOpenaiUrl: string | undefined;\n  let origAnthropicUrl: string | undefined;\n\n  beforeAll(async () => {\n    const { fixtures: fixturePath, patchEnv, ...serverOpts } = options;\n    const llm = new LLMock(serverOpts);\n\n    if (fixturePath) {\n      const resolved = resolve(fixturePath);\n      const loadedFixtures = loadFixtures(resolved, options.live);\n      for (const f of loadedFixtures) {\n        llm.addFixture(f);\n      }\n    }\n\n    const url = await llm.start();\n\n    if (patchEnv !== false) {\n      origOpenaiUrl = process.env.OPENAI_BASE_URL;\n      origAnthropicUrl = process.env.ANTHROPIC_BASE_URL;\n      process.env.OPENAI_BASE_URL = `${url}/v1`;\n      process.env.ANTHROPIC_BASE_URL = `${url}/v1`;\n    }\n\n    handle = { llm, url };\n  });\n\n  beforeEach(() => {\n    if (handle) {\n      handle.llm.closeLiveSessions();\n      handle.llm.resetMatchCounts();\n    }\n  });\n\n  afterEach(() => {\n    handle?.llm.closeLiveSessions();\n  });\n\n  afterAll(async () => {\n    if (handle) {\n      if (options.patchEnv !== false) {\n        if (origOpenaiUrl !== undefined) process.env.OPENAI_BASE_URL = origOpenaiUrl;\n        else delete process.env.OPENAI_BASE_URL;\n        if (origAnthropicUrl !== undefined) process.env.ANTHROPIC_BASE_URL = origAnthropicUrl;\n        else delete process.env.ANTHROPIC_BASE_URL;\n      }\n      await handle.llm.stop();\n      handle = null;\n    }\n  });\n\n  return () => {\n    if (!handle) {\n      throw new Error(\"useAimock(): server not started — are you calling this inside a test?\");\n    }\n    return handle;\n  };\n}\n\nfunction loadFixtures(fixturePath: string, liveOptions?: LiveOptions): Fixture[] {\n  try {\n    const stat = statSync(fixturePath);\n    if (stat.isDirectory()) {\n      return loadFixturesFromDir(fixturePath, undefined, liveOptions);\n    }\n    return loadFixtureFile(fixturePath, undefined, liveOptions);\n  } catch (err) {\n    console.warn(\n      `[aimock] Failed to load fixtures from ${fixturePath}: ${err instanceof Error ? err.message : String(err)}`,\n    );\n    return [];\n  }\n}\n\nexport { LLMock } from \"./llmock.js\";\nexport type { MockServerOptions, Fixture } from \"./types.js\";\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;AAuDA,SAAgB,UAAU,UAA4B,EAAE,EAAsB;CAC5E,IAAI,SAA8B;CAClC,IAAI;CACJ,IAAI;AAEJ,WAAU,YAAY;EACpB,MAAM,EAAE,UAAU,aAAa,UAAU,GAAG,eAAe;EAC3D,MAAM,MAAM,IAAIA,sBAAO,WAAW;AAElC,MAAI,aAAa;GAEf,MAAM,iBAAiB,oCADE,YAAY,EACS,QAAQ,KAAK;AAC3D,QAAK,MAAM,KAAK,eACd,KAAI,WAAW,EAAE;;EAIrB,MAAM,MAAM,MAAM,IAAI,OAAO;AAE7B,MAAI,aAAa,OAAO;AACtB,mBAAgB,QAAQ,IAAI;AAC5B,sBAAmB,QAAQ,IAAI;AAC/B,WAAQ,IAAI,kBAAkB,GAAG,IAAI;AACrC,WAAQ,IAAI,qBAAqB,GAAG,IAAI;;AAG1C,WAAS;GAAE;GAAK;GAAK;GACrB;AAEF,kBAAiB;AACf,MAAI,QAAQ;AACV,UAAO,IAAI,mBAAmB;AAC9B,UAAO,IAAI,kBAAkB;;GAE/B;AAEF,iBAAgB;AACd,UAAQ,IAAI,mBAAmB;GAC/B;AAEF,UAAS,YAAY;AACnB,MAAI,QAAQ;AACV,OAAI,QAAQ,aAAa,OAAO;AAC9B,QAAI,kBAAkB,OAAW,SAAQ,IAAI,kBAAkB;QAC1D,QAAO,QAAQ,IAAI;AACxB,QAAI,qBAAqB,OAAW,SAAQ,IAAI,qBAAqB;QAChE,QAAO,QAAQ,IAAI;;AAE1B,SAAM,OAAO,IAAI,MAAM;AACvB,YAAS;;GAEX;AAEF,cAAa;AACX,MAAI,CAAC,OACH,OAAM,IAAI,MAAM,wEAAwE;AAE1F,SAAO;;;AAIX,SAAS,aAAa,aAAqB,aAAsC;AAC/E,KAAI;AAEF,4BADsB,YAAY,CACzB,aAAa,CACpB,QAAOC,2CAAoB,aAAa,QAAW,YAAY;AAEjE,SAAOC,uCAAgB,aAAa,QAAW,YAAY;UACpD,KAAK;AACZ,UAAQ,KACN,yCAAyC,YAAY,IAAI,eAAe,QAAQ,IAAI,UAAU,OAAO,IAAI,GAC1G;AACD,SAAO,EAAE"}
+{"version":3,"file":"jest.cjs","names":["AimockTestIdCollisionError","sep","TEST_ID_SEPARATOR","FakesPluginState","fakesReportMode","LLMock","fakesTarget","fetchFakesReport","FixtureLoadError","MisbehaviorConfigError"],"sources":["../src/jest.ts"],"sourcesContent":["/**\n * Jest integration for aimock.\n *\n * Usage:\n *   import { useAimock } from \"@copilotkit/aimock/jest\";\n *\n *   const mock = useAimock({ fixtures: \"./fixtures\" });\n *\n *   it(\"responds\", async () => {\n *     const res = await fetch(`${mock().url}/v1/chat/completions`, { ... });\n *   });\n */\n\n/* eslint-disable no-var */\n// Jest globals — available at runtime in jest test files\ndeclare var beforeAll: (fn: () => Promise<void> | void, timeout?: number) => void;\ndeclare var afterAll: (fn: () => Promise<void> | void, timeout?: number) => void;\ndeclare var beforeEach: (fn: () => Promise<void> | void, timeout?: number) => void;\ndeclare var afterEach: (fn: () => Promise<void> | void, timeout?: number) => void;\ndeclare var expect: { getState(): { testPath?: string; currentTestName?: string } };\n/* eslint-enable no-var */\n\nimport { LLMock } from \"./llmock.js\";\nimport { FixtureLoadError, MisbehaviorConfigError } from \"./fixture-loader.js\";\nimport type { MockServerOptions } from \"./types.js\";\nimport {\n  FakesPluginState,\n  TEST_ID_SEPARATOR,\n  fakesReportMode,\n  fakesTarget,\n  fetchFakesReport,\n  type FakesForOptions,\n  type FakesReportMode,\n  type FakesTarget,\n} from \"./fakes-plugin.js\";\nimport { AimockTestIdCollisionError, type McpFakesReport } from \"./mcp-fakes-report.js\";\nimport { statSync } from \"node:fs\";\nimport { relative, resolve, sep } from \"node:path\";\n\nexport interface UseAimockOptions extends MockServerOptions {\n  /** Path to fixture file or directory. Loaded automatically on start. */\n  fixtures?: string;\n  /** If true, sets process.env.OPENAI_BASE_URL to the mock URL + /v1. */\n  patchEnv?: boolean;\n  /**\n   * The per-test MCP fake report, read in `afterEach` (RP7): `\"off\"` (the\n   * default), `\"warn\"` (print a failing report) or `\"fail\"` (throw\n   * `AimockFakesReportError`). Not supported with `test.concurrent`: the\n   * report keeps one state per `useAimock`, so concurrent tests clear and read\n   * each other's identities, and Jest cannot tell this plugin that a test is\n   * concurrent. Keep `\"off\"` for a suite with concurrent tests.\n   */\n  fakesReport?: FakesReportMode;\n  /**\n   * The directory default test ids are relative to (TI2). Defaults to\n   * `process.cwd()` when `useAimock` is called; Jest does not expose\n   * `rootDir` to test code.\n   */\n  testIdRoot?: string;\n}\n\nexport interface AimockHandle {\n  /** The LLMock instance. */\n  readonly llm: LLMock;\n  /** The server URL (e.g., http://127.0.0.1:4010). */\n  readonly url: string;\n}\n\n/**\n * The handle `useAimock` returns: an `AimockHandle` plus the MCP fakes\n * helpers (RP7). A separate type, so that `AimockHandle` stays as it was and\n * code that builds its own `AimockHandle` keeps compiling.\n */\nexport interface AimockFakesHandle extends AimockHandle {\n  /**\n   * The MCP URL and headers for the fakes scoped to `testId` (RP7), and\n   * registers that identity for this test's report. With no `testId`, the\n   * default is `<test file relative to testIdRoot> › <currentTestName>` (TI2);\n   * it is used only here and in `fakesReport`, never on LLM traffic (TI4).\n   * Two tests with the same full name in one file share a default id (TI5):\n   * pass an explicit `testId` for them. In `test.concurrent`, Jest can\n   * report another test's name, so pass an explicit `testId` there too (with\n   * `fakesReport: \"off\"`; the report is not supported in concurrent tests).\n   */\n  fakesFor(testId?: string, opts?: FakesForOptions): FakesTarget;\n  /** The MCP fake report for `testId` (default as in `fakesFor`). */\n  fakesReport(testId?: string, opts?: { context?: string }): Promise<McpFakesReport>;\n}\n\n/** TI2: `<testPath relative to root, with \"/\"> › <currentTestName>`. */\nfunction defaultJestId(root: string): string {\n  const { testPath, currentTestName } = expect.getState();\n  if (!testPath || currentTestName === undefined) {\n    throw new AimockTestIdCollisionError(\n      \"default test ids are not supported here (concurrent test or no running test); pass an explicit testId\",\n    );\n  }\n  return relative(root, testPath).split(sep).join(\"/\") + TEST_ID_SEPARATOR + currentTestName;\n}\n\n/**\n * Start an aimock server for the duration of the test suite.\n *\n * - `beforeAll`: starts the server and optionally loads fixtures (LLM fixtures and\n *   `mcpFakes` blocks; a bad `mcpFakes` block fails `beforeAll`)\n * - `beforeEach`: closes Live sessions and resets fixture match counts and MCP fake\n *   consumption (not fixtures or fakes)\n * - `afterEach`: closes Live sessions owned by this helper's server, then checks\n *   the MCP fake report under `fakesReport: \"warn\" | \"fail\"`\n * - `afterAll`: stops the server\n *\n * Returns a getter function — call it inside tests to access the handle.\n *\n * NOTE: Jest globals (beforeAll, afterAll, beforeEach, afterEach) must be available\n * in the test environment. This works with the default jest configuration.\n */\nexport function useAimock(options: UseAimockOptions = {}): () => AimockFakesHandle {\n  let handle: AimockFakesHandle | null = null;\n  let origOpenaiUrl: string | undefined;\n  let origAnthropicUrl: string | undefined;\n  const root = resolve(options.testIdRoot ?? process.cwd());\n  let state = new FakesPluginState(\"off\");\n\n  beforeAll(async () => {\n    const { fixtures: fixturePath, patchEnv, fakesReport, testIdRoot, ...serverOpts } = options;\n    void testIdRoot; // read above, when useAimock is called\n    state = new FakesPluginState(fakesReportMode(fakesReport));\n    const llm = new LLMock(serverOpts);\n\n    if (fixturePath) {\n      loadFixtures(llm, resolve(fixturePath));\n    }\n\n    const url = await llm.start();\n\n    if (patchEnv !== false) {\n      origOpenaiUrl = process.env.OPENAI_BASE_URL;\n      origAnthropicUrl = process.env.ANTHROPIC_BASE_URL;\n      process.env.OPENAI_BASE_URL = `${url}/v1`;\n      process.env.ANTHROPIC_BASE_URL = `${url}/v1`;\n    }\n\n    handle = {\n      llm,\n      url,\n      fakesFor(testId?: string, opts: FakesForOptions = {}): FakesTarget {\n        const id = testId ?? defaultJestId(root); // TI4: an explicit id wins\n        state.register(id, opts.context ?? null);\n        return fakesTarget(url, id, opts);\n      },\n      fakesReport(testId?: string, opts: { context?: string } = {}): Promise<McpFakesReport> {\n        return fetchFakesReport(url, testId ?? defaultJestId(root), opts.context ?? null);\n      },\n    };\n  });\n\n  beforeEach(() => {\n    if (handle) {\n      handle.llm.closeLiveSessions();\n      handle.llm.resetMatchCounts();\n      state.beforeEach(handle.llm);\n    }\n  });\n\n  afterEach(async () => {\n    handle?.llm.closeLiveSessions();\n    if (handle) await state.afterEach(handle.llm, handle.url);\n  });\n\n  afterAll(async () => {\n    if (handle) {\n      if (options.patchEnv !== false) {\n        if (origOpenaiUrl !== undefined) process.env.OPENAI_BASE_URL = origOpenaiUrl;\n        else delete process.env.OPENAI_BASE_URL;\n        if (origAnthropicUrl !== undefined) process.env.ANTHROPIC_BASE_URL = origAnthropicUrl;\n        else delete process.env.ANTHROPIC_BASE_URL;\n      }\n      await handle.llm.stop();\n      handle = null;\n    }\n  });\n\n  return () => {\n    if (!handle) {\n      throw new Error(\"useAimock(): server not started — are you calling this inside a test?\");\n    }\n    return handle;\n  };\n}\n\n/**\n * Load a fixture file or directory into `llm`: its LLM fixtures and its\n * `mcpFakes` blocks, which the LLMock buffers and auto-mounts at start (F12).\n * A `FixtureLoadError` (a bad `mcpFakes` block) or a `MisbehaviorConfigError`\n * (a bad fixture `misbehavior` key, thrown only with `enableMisbehavior: true`)\n * propagates and fails `beforeAll`; any other load failure is only warned\n * about, as before.\n */\nfunction loadFixtures(llm: LLMock, fixturePath: string): void {\n  try {\n    const stat = statSync(fixturePath);\n    if (stat.isDirectory()) {\n      llm.loadFixtureDir(fixturePath);\n    } else {\n      llm.loadFixtureFile(fixturePath);\n    }\n  } catch (err) {\n    if (err instanceof FixtureLoadError || err instanceof MisbehaviorConfigError) throw err;\n    console.warn(\n      `[aimock] Failed to load fixtures from ${fixturePath}: ${err instanceof Error ? err.message : String(err)}`,\n    );\n  }\n}\n\nexport { LLMock } from \"./llmock.js\";\nexport type { MockServerOptions, Fixture } from \"./types.js\";\nexport type { FakesForOptions, FakesReportMode, FakesTarget } from \"./fakes-plugin.js\";\nexport type { McpFakesReport } from \"./mcp-fakes-report.js\";\n"],"mappings":";;;;;;;;;;;AA0FA,SAAS,cAAc,MAAsB;CAC3C,MAAM,EAAE,UAAU,oBAAoB,OAAO,UAAU;AACvD,KAAI,CAAC,YAAY,oBAAoB,OACnC,OAAM,IAAIA,oDACR,wGACD;AAEH,gCAAgB,MAAM,SAAS,CAAC,MAAMC,cAAI,CAAC,KAAK,IAAI,GAAGC,yCAAoB;;;;;;;;;;;;;;;;;;AAmB7E,SAAgB,UAAU,UAA4B,EAAE,EAA2B;CACjF,IAAI,SAAmC;CACvC,IAAI;CACJ,IAAI;CACJ,MAAM,8BAAe,QAAQ,cAAc,QAAQ,KAAK,CAAC;CACzD,IAAI,QAAQ,IAAIC,sCAAiB,MAAM;AAEvC,WAAU,YAAY;EACpB,MAAM,EAAE,UAAU,aAAa,UAAU,aAAa,YAAY,GAAG,eAAe;AAEpF,UAAQ,IAAIA,sCAAiBC,qCAAgB,YAAY,CAAC;EAC1D,MAAM,MAAM,IAAIC,sBAAO,WAAW;AAElC,MAAI,YACF,cAAa,4BAAa,YAAY,CAAC;EAGzC,MAAM,MAAM,MAAM,IAAI,OAAO;AAE7B,MAAI,aAAa,OAAO;AACtB,mBAAgB,QAAQ,IAAI;AAC5B,sBAAmB,QAAQ,IAAI;AAC/B,WAAQ,IAAI,kBAAkB,GAAG,IAAI;AACrC,WAAQ,IAAI,qBAAqB,GAAG,IAAI;;AAG1C,WAAS;GACP;GACA;GACA,SAAS,QAAiB,OAAwB,EAAE,EAAe;IACjE,MAAM,KAAK,UAAU,cAAc,KAAK;AACxC,UAAM,SAAS,IAAI,KAAK,WAAW,KAAK;AACxC,WAAOC,iCAAY,KAAK,IAAI,KAAK;;GAEnC,YAAY,QAAiB,OAA6B,EAAE,EAA2B;AACrF,WAAOC,sCAAiB,KAAK,UAAU,cAAc,KAAK,EAAE,KAAK,WAAW,KAAK;;GAEpF;GACD;AAEF,kBAAiB;AACf,MAAI,QAAQ;AACV,UAAO,IAAI,mBAAmB;AAC9B,UAAO,IAAI,kBAAkB;AAC7B,SAAM,WAAW,OAAO,IAAI;;GAE9B;AAEF,WAAU,YAAY;AACpB,UAAQ,IAAI,mBAAmB;AAC/B,MAAI,OAAQ,OAAM,MAAM,UAAU,OAAO,KAAK,OAAO,IAAI;GACzD;AAEF,UAAS,YAAY;AACnB,MAAI,QAAQ;AACV,OAAI,QAAQ,aAAa,OAAO;AAC9B,QAAI,kBAAkB,OAAW,SAAQ,IAAI,kBAAkB;QAC1D,QAAO,QAAQ,IAAI;AACxB,QAAI,qBAAqB,OAAW,SAAQ,IAAI,qBAAqB;QAChE,QAAO,QAAQ,IAAI;;AAE1B,SAAM,OAAO,IAAI,MAAM;AACvB,YAAS;;GAEX;AAEF,cAAa;AACX,MAAI,CAAC,OACH,OAAM,IAAI,MAAM,wEAAwE;AAE1F,SAAO;;;;;;;;;;;AAYX,SAAS,aAAa,KAAa,aAA2B;AAC5D,KAAI;AAEF,4BADsB,YAAY,CACzB,aAAa,CACpB,KAAI,eAAe,YAAY;MAE/B,KAAI,gBAAgB,YAAY;UAE3B,KAAK;AACZ,MAAI,eAAeC,2CAAoB,eAAeC,8CAAwB,OAAM;AACpF,UAAQ,KACN,yCAAyC,YAAY,IAAI,eAAe,QAAQ,IAAI,UAAU,OAAO,IAAI,GAC1G"}

package/dist/jest.d.cts

@@ -1,5 +1,7 @@
 import { Fixture, MockServerOptions } from "./types.cjs";
 import { LLMock } from "./llmock.cjs";
+import { McpFakesReport } from "./mcp-fakes-report.cjs";
+import { FakesForOptions, FakesReportMode, FakesTarget } from "./fakes-plugin.cjs";
 
 //#region src/jest.d.ts
 
@@ -8,6 +10,21 @@ interface UseAimockOptions extends MockServerOptions {
   fixtures?: string;
   /** If true, sets process.env.OPENAI_BASE_URL to the mock URL + /v1. */
   patchEnv?: boolean;
+  /**
+   * The per-test MCP fake report, read in `afterEach` (RP7): `"off"` (the
+   * default), `"warn"` (print a failing report) or `"fail"` (throw
+   * `AimockFakesReportError`). Not supported with `test.concurrent`: the
+   * report keeps one state per `useAimock`, so concurrent tests clear and read
+   * each other's identities, and Jest cannot tell this plugin that a test is
+   * concurrent. Keep `"off"` for a suite with concurrent tests.
+   */
+  fakesReport?: FakesReportMode;
+  /**
+   * The directory default test ids are relative to (TI2). Defaults to
+   * `process.cwd()` when `useAimock` is called; Jest does not expose
+   * `rootDir` to test code.
+   */
+  testIdRoot?: string;
 }
 interface AimockHandle {
   /** The LLMock instance. */
@@ -15,12 +32,37 @@ interface AimockHandle {
   /** The server URL (e.g., http://127.0.0.1:4010). */
   readonly url: string;
 }
+/**
+ * The handle `useAimock` returns: an `AimockHandle` plus the MCP fakes
+ * helpers (RP7). A separate type, so that `AimockHandle` stays as it was and
+ * code that builds its own `AimockHandle` keeps compiling.
+ */
+interface AimockFakesHandle extends AimockHandle {
+  /**
+   * The MCP URL and headers for the fakes scoped to `testId` (RP7), and
+   * registers that identity for this test's report. With no `testId`, the
+   * default is `<test file relative to testIdRoot> › <currentTestName>` (TI2);
+   * it is used only here and in `fakesReport`, never on LLM traffic (TI4).
+   * Two tests with the same full name in one file share a default id (TI5):
+   * pass an explicit `testId` for them. In `test.concurrent`, Jest can
+   * report another test's name, so pass an explicit `testId` there too (with
+   * `fakesReport: "off"`; the report is not supported in concurrent tests).
+   */
+  fakesFor(testId?: string, opts?: FakesForOptions): FakesTarget;
+  /** The MCP fake report for `testId` (default as in `fakesFor`). */
+  fakesReport(testId?: string, opts?: {
+    context?: string;
+  }): Promise<McpFakesReport>;
+}
 /**
  * Start an aimock server for the duration of the test suite.
  *
- * - `beforeAll`: starts the server and optionally loads fixtures
- * - `beforeEach`: closes Live sessions and resets fixture match counts (not fixtures)
- * - `afterEach`: closes Live sessions owned by this helper's server
+ * - `beforeAll`: starts the server and optionally loads fixtures (LLM fixtures and
+ *   `mcpFakes` blocks; a bad `mcpFakes` block fails `beforeAll`)
+ * - `beforeEach`: closes Live sessions and resets fixture match counts and MCP fake
+ *   consumption (not fixtures or fakes)
+ * - `afterEach`: closes Live sessions owned by this helper's server, then checks
+ *   the MCP fake report under `fakesReport: "warn" | "fail"`
  * - `afterAll`: stops the server
  *
  * Returns a getter function — call it inside tests to access the handle.
@@ -28,7 +70,7 @@ interface AimockHandle {
  * NOTE: Jest globals (beforeAll, afterAll, beforeEach, afterEach) must be available
  * in the test environment. This works with the default jest configuration.
  */
-declare function useAimock(options?: UseAimockOptions): () => AimockHandle;
+declare function useAimock(options?: UseAimockOptions): () => AimockFakesHandle;
 //#endregion
-export { AimockHandle, type Fixture, LLMock, type MockServerOptions, UseAimockOptions, useAimock };
+export { AimockFakesHandle, AimockHandle, type FakesForOptions, type FakesReportMode, type FakesTarget, type Fixture, LLMock, type McpFakesReport, type MockServerOptions, UseAimockOptions, useAimock };
 //# sourceMappingURL=jest.d.cts.map

package/dist/jest.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"jest.d.cts","names":[],"sources":["../src/jest.ts"],"sourcesContent":[],"mappings":";;;;;UA4BiB,gBAAA,SAAyB;;;;;;UAOzB,YAAA;;gBAED;;;;;;;;;;;;;;;;;iBAkBA,SAAA,WAAmB,yBAA8B"}
+{"version":3,"file":"jest.d.cts","names":[],"sources":["../src/jest.ts"],"sourcesContent":[],"mappings":";;;;;;;AAsFqE,UA/CpD,gBAAA,SAAyB,iBA+C2B,CAAA;;UAb1B,CAAA,EAAA,MAAA;EAAY;EA2CvC,QAAA,CAAA,EAAA,OAAS;EAAA;;;;;;;;gBAhET;;;;;;;;UASC,YAAA;;gBAED;;;;;;;;;UAUC,iBAAA,SAA0B;;;;;;;;;;;mCAWR,kBAAkB;;;;MAEQ,QAAQ;;;;;;;;;;;;;;;;;;iBA8BrD,SAAA,WAAmB,yBAA8B"}

package/dist/jest.d.ts

@@ -1,5 +1,7 @@
 import { Fixture, MockServerOptions } from "./types.js";
 import { LLMock } from "./llmock.js";
+import { McpFakesReport } from "./mcp-fakes-report.js";
+import { FakesForOptions, FakesReportMode, FakesTarget } from "./fakes-plugin.js";
 
 //#region src/jest.d.ts
 
@@ -8,6 +10,21 @@ interface UseAimockOptions extends MockServerOptions {
   fixtures?: string;
   /** If true, sets process.env.OPENAI_BASE_URL to the mock URL + /v1. */
   patchEnv?: boolean;
+  /**
+   * The per-test MCP fake report, read in `afterEach` (RP7): `"off"` (the
+   * default), `"warn"` (print a failing report) or `"fail"` (throw
+   * `AimockFakesReportError`). Not supported with `test.concurrent`: the
+   * report keeps one state per `useAimock`, so concurrent tests clear and read
+   * each other's identities, and Jest cannot tell this plugin that a test is
+   * concurrent. Keep `"off"` for a suite with concurrent tests.
+   */
+  fakesReport?: FakesReportMode;
+  /**
+   * The directory default test ids are relative to (TI2). Defaults to
+   * `process.cwd()` when `useAimock` is called; Jest does not expose
+   * `rootDir` to test code.
+   */
+  testIdRoot?: string;
 }
 interface AimockHandle {
   /** The LLMock instance. */
@@ -15,12 +32,37 @@ interface AimockHandle {
   /** The server URL (e.g., http://127.0.0.1:4010). */
   readonly url: string;
 }
+/**
+ * The handle `useAimock` returns: an `AimockHandle` plus the MCP fakes
+ * helpers (RP7). A separate type, so that `AimockHandle` stays as it was and
+ * code that builds its own `AimockHandle` keeps compiling.
+ */
+interface AimockFakesHandle extends AimockHandle {
+  /**
+   * The MCP URL and headers for the fakes scoped to `testId` (RP7), and
+   * registers that identity for this test's report. With no `testId`, the
+   * default is `<test file relative to testIdRoot> › <currentTestName>` (TI2);
+   * it is used only here and in `fakesReport`, never on LLM traffic (TI4).
+   * Two tests with the same full name in one file share a default id (TI5):
+   * pass an explicit `testId` for them. In `test.concurrent`, Jest can
+   * report another test's name, so pass an explicit `testId` there too (with
+   * `fakesReport: "off"`; the report is not supported in concurrent tests).
+   */
+  fakesFor(testId?: string, opts?: FakesForOptions): FakesTarget;
+  /** The MCP fake report for `testId` (default as in `fakesFor`). */
+  fakesReport(testId?: string, opts?: {
+    context?: string;
+  }): Promise<McpFakesReport>;
+}
 /**
  * Start an aimock server for the duration of the test suite.
  *
- * - `beforeAll`: starts the server and optionally loads fixtures
- * - `beforeEach`: closes Live sessions and resets fixture match counts (not fixtures)
- * - `afterEach`: closes Live sessions owned by this helper's server
+ * - `beforeAll`: starts the server and optionally loads fixtures (LLM fixtures and
+ *   `mcpFakes` blocks; a bad `mcpFakes` block fails `beforeAll`)
+ * - `beforeEach`: closes Live sessions and resets fixture match counts and MCP fake
+ *   consumption (not fixtures or fakes)
+ * - `afterEach`: closes Live sessions owned by this helper's server, then checks
+ *   the MCP fake report under `fakesReport: "warn" | "fail"`
  * - `afterAll`: stops the server
  *
  * Returns a getter function — call it inside tests to access the handle.
@@ -28,7 +70,7 @@ interface AimockHandle {
  * NOTE: Jest globals (beforeAll, afterAll, beforeEach, afterEach) must be available
  * in the test environment. This works with the default jest configuration.
  */
-declare function useAimock(options?: UseAimockOptions): () => AimockHandle;
+declare function useAimock(options?: UseAimockOptions): () => AimockFakesHandle;
 //#endregion
-export { AimockHandle, type Fixture, LLMock, type MockServerOptions, UseAimockOptions, useAimock };
+export { AimockFakesHandle, AimockHandle, type FakesForOptions, type FakesReportMode, type FakesTarget, type Fixture, LLMock, type McpFakesReport, type MockServerOptions, UseAimockOptions, useAimock };
 //# sourceMappingURL=jest.d.ts.map

package/dist/jest.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"jest.d.ts","names":[],"sources":["../src/jest.ts"],"sourcesContent":[],"mappings":";;;;;UA4BiB,gBAAA,SAAyB;;;;;;UAOzB,YAAA;;gBAED;;;;;;;;;;;;;;;;;iBAkBA,SAAA,WAAmB,yBAA8B"}
+{"version":3,"file":"jest.d.ts","names":[],"sources":["../src/jest.ts"],"sourcesContent":[],"mappings":";;;;;;;AAsFqE,UA/CpD,gBAAA,SAAyB,iBA+C2B,CAAA;;UAb1B,CAAA,EAAA,MAAA;EAAY;EA2CvC,QAAA,CAAA,EAAA,OAAS;EAAA;;;;;;;;gBAhET;;;;;;;;UASC,YAAA;;gBAED;;;;;;;;;UAUC,iBAAA,SAA0B;;;;;;;;;;;mCAWR,kBAAkB;;;;MAEQ,QAAQ;;;;;;;;;;;;;;;;;;iBA8BrD,SAAA,WAAmB,yBAA8B"}

package/dist/jest.js

@@ -1,15 +1,26 @@
-import { loadFixtureFile, loadFixturesFromDir } from "./fixture-loader.js";
+import { FixtureLoadError, MisbehaviorConfigError } from "./fixture-loader.js";
+import { AimockTestIdCollisionError } from "./mcp-fakes-report.js";
 import { LLMock } from "./llmock.js";
+import { FakesPluginState, TEST_ID_SEPARATOR, fakesReportMode, fakesTarget, fetchFakesReport } from "./fakes-plugin.js";
 import { statSync } from "node:fs";
-import { resolve } from "node:path";
+import { relative, resolve, sep } from "node:path";
 
 //#region src/jest.ts
+/** TI2: `<testPath relative to root, with "/"> › <currentTestName>`. */
+function defaultJestId(root) {
+	const { testPath, currentTestName } = expect.getState();
+	if (!testPath || currentTestName === void 0) throw new AimockTestIdCollisionError("default test ids are not supported here (concurrent test or no running test); pass an explicit testId");
+	return relative(root, testPath).split(sep).join("/") + TEST_ID_SEPARATOR + currentTestName;
+}
 /**
 * Start an aimock server for the duration of the test suite.
 *
-* - `beforeAll`: starts the server and optionally loads fixtures
-* - `beforeEach`: closes Live sessions and resets fixture match counts (not fixtures)
-* - `afterEach`: closes Live sessions owned by this helper's server
+* - `beforeAll`: starts the server and optionally loads fixtures (LLM fixtures and
+*   `mcpFakes` blocks; a bad `mcpFakes` block fails `beforeAll`)
+* - `beforeEach`: closes Live sessions and resets fixture match counts and MCP fake
+*   consumption (not fixtures or fakes)
+* - `afterEach`: closes Live sessions owned by this helper's server, then checks
+*   the MCP fake report under `fakesReport: "warn" | "fail"`
 * - `afterAll`: stops the server
 *
 * Returns a getter function — call it inside tests to access the handle.
@@ -21,13 +32,13 @@ function useAimock(options = {}) {
 	let handle = null;
 	let origOpenaiUrl;
 	let origAnthropicUrl;
+	const root = resolve(options.testIdRoot ?? process.cwd());
+	let state = new FakesPluginState("off");
 	beforeAll(async () => {
-		const { fixtures: fixturePath, patchEnv, ...serverOpts } = options;
+		const { fixtures: fixturePath, patchEnv, fakesReport, testIdRoot, ...serverOpts } = options;
+		state = new FakesPluginState(fakesReportMode(fakesReport));
 		const llm = new LLMock(serverOpts);
-		if (fixturePath) {
-			const loadedFixtures = loadFixtures(resolve(fixturePath), options.live);
-			for (const f of loadedFixtures) llm.addFixture(f);
-		}
+		if (fixturePath) loadFixtures(llm, resolve(fixturePath));
 		const url = await llm.start();
 		if (patchEnv !== false) {
 			origOpenaiUrl = process.env.OPENAI_BASE_URL;
@@ -37,17 +48,27 @@ function useAimock(options = {}) {
 		}
 		handle = {
 			llm,
-			url
+			url,
+			fakesFor(testId, opts = {}) {
+				const id = testId ?? defaultJestId(root);
+				state.register(id, opts.context ?? null);
+				return fakesTarget(url, id, opts);
+			},
+			fakesReport(testId, opts = {}) {
+				return fetchFakesReport(url, testId ?? defaultJestId(root), opts.context ?? null);
+			}
 		};
 	});
 	beforeEach(() => {
 		if (handle) {
 			handle.llm.closeLiveSessions();
 			handle.llm.resetMatchCounts();
+			state.beforeEach(handle.llm);
 		}
 	});
-	afterEach(() => {
+	afterEach(async () => {
 		handle?.llm.closeLiveSessions();
+		if (handle) await state.afterEach(handle.llm, handle.url);
 	});
 	afterAll(async () => {
 		if (handle) {
@@ -66,13 +87,21 @@ function useAimock(options = {}) {
 		return handle;
 	};
 }
-function loadFixtures(fixturePath, liveOptions) {
+/**
+* Load a fixture file or directory into `llm`: its LLM fixtures and its
+* `mcpFakes` blocks, which the LLMock buffers and auto-mounts at start (F12).
+* A `FixtureLoadError` (a bad `mcpFakes` block) or a `MisbehaviorConfigError`
+* (a bad fixture `misbehavior` key, thrown only with `enableMisbehavior: true`)
+* propagates and fails `beforeAll`; any other load failure is only warned
+* about, as before.
+*/
+function loadFixtures(llm, fixturePath) {
 	try {
-		if (statSync(fixturePath).isDirectory()) return loadFixturesFromDir(fixturePath, void 0, liveOptions);
-		return loadFixtureFile(fixturePath, void 0, liveOptions);
+		if (statSync(fixturePath).isDirectory()) llm.loadFixtureDir(fixturePath);
+		else llm.loadFixtureFile(fixturePath);
 	} catch (err) {
+		if (err instanceof FixtureLoadError || err instanceof MisbehaviorConfigError) throw err;
 		console.warn(`[aimock] Failed to load fixtures from ${fixturePath}: ${err instanceof Error ? err.message : String(err)}`);
-		return [];
 	}
 }