@copilotkit/aimock 1.42.1 → 1.44.0

package/dist/types.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.cjs","names":[],"sources":["../src/types.ts"],"sourcesContent":["import type * as http from \"node:http\";\nimport type * as net from \"node:net\";\nimport type { Journal } from \"./journal.js\";\nimport type { LiveFixtureResponse, LiveOptions } from \"./live-types.js\";\nimport type { Logger } from \"./logger.js\";\nimport type { MetricsRegistry } from \"./metrics.js\";\nimport type { McpFakeAddOrigin, McpFakeAddResult } from \"./mcp-fakes.js\";\n\n// aimock type definitions — shared across all provider adapters and the fixture router.\n\nexport interface Mountable {\n  handleRequest(\n    req: http.IncomingMessage,\n    res: http.ServerResponse,\n    pathname: string,\n  ): Promise<boolean>;\n  handleUpgrade?(socket: net.Socket, head: Buffer, pathname: string): Promise<boolean>;\n  health?(): { status: string; [key: string]: unknown };\n  setJournal?(journal: Journal): void;\n  setBaseUrl?(url: string): void;\n  setRegistry?(registry: MetricsRegistry): void;\n  /**\n   * MCP fakes. A mount \"is an MCPMock\" for fakes if and only if it\n   * implements `addMcpFakes`. Always appends. `origin` picks the entry-id\n   * source and its counter: `file` keeps each block's `source` (`@<k>` load\n   * counter); `code` / `control-api` is one run-time addition (`code#<n>` /\n   * `control-api#<n>`). Returns the shadowed-entry warnings with the real\n   * entry ids. When any block is bad, or the input holds no blocks, throws one\n   * `FixtureLoadError` (an `McpFakesAddError` carrying every error found and\n   * the warnings) and adds nothing.\n   */\n  addMcpFakes?(blocks: McpFakeSource[], origin: McpFakeAddOrigin): McpFakeAddResult;\n  /** Unload every fake on this mount. The entry-id counters are kept. */\n  clearMcpFakes?(): void;\n  /** Reset fake consumption state for one test id, or for all when omitted. */\n  resetScenarioState?(testId?: string): void;\n  /** Hands an MCP mount a `Logger`. Nothing in the server calls it. */\n  setLogger?(logger: Logger): void;\n}\n\nexport interface ContentPart {\n  type: string;\n  text?: string;\n  [key: string]: unknown;\n}\n\nexport interface ChatMessage {\n  role: \"system\" | \"user\" | \"assistant\" | \"tool\";\n  content: string | ContentPart[] | null;\n  name?: string;\n  tool_calls?: ToolCallMessage[];\n  tool_call_id?: string;\n}\n\nexport interface ToolCallMessage {\n  id: string;\n  type: \"function\";\n  function: { name: string; arguments: string };\n}\n\nexport interface ChatCompletionRequest {\n  model: string;\n  messages: ChatMessage[];\n  stream?: boolean;\n  /**\n   * OpenRouter fallback model list. When present (and the request arrived on\n   * the OpenRouter `/api/v1/...` base), the candidate list `[model, ...models]`\n   * is attempted in order. A NON-error fixture match wins; an ERROR fixture\n   * candidate falls through to the next candidate by default — UNLESS it is\n   * terminal, in which case that error is served with no failover. An error is\n   * terminal when its fixture sets `fallthrough: false` (per-error-class gate)\n   * or when the request sets `provider.allow_fallbacks: false` (request-level\n   * gate). A winning (non-error) slug is echoed back as the response `model`;\n   * when the chain terminates on an error, the response is the OpenRouter error\n   * envelope (`{ error: { code, message, metadata? } }`), which carries no\n   * `model` field. Purely additive: a request without `models` behaves as a\n   * single-model match. Every other\n   * OpenRouter request extension (`route`, `reasoning`, `plugins`,\n   * `prediction`, `usage`, and any unknown key) is accepted and journaled via\n   * the index signature below — never required, never rejected. aimock does not\n   * model those sub-shapes; unknown body keys pass straight through.\n   */\n  models?: string[];\n  /**\n   * OpenRouter provider-routing preferences. Accepted loosely and journaled\n   * verbatim; the ONLY sub-field aimock reads behaviorally is\n   * `allow_fallbacks`. When `allow_fallbacks === false` on an OpenRouter\n   * request, the `models[]` fallback loop is suppressed — only the primary is\n   * tried, and a primary error fixture is served as terminal instead of\n   * falling through (the fail-CLOSED half of the feature). Absent/`true` keeps\n   * the default fall-through behavior. Every other provider-prefs key\n   * (`order`, `only`, `ignore`, `sort`, …) passes straight through unread.\n   */\n  provider?: { allow_fallbacks?: boolean; [key: string]: unknown };\n  stream_options?: { include_usage?: boolean; [key: string]: unknown };\n  temperature?: number;\n  max_tokens?: number;\n  tools?: ToolDefinition[];\n  tool_choice?: string | object;\n  response_format?: { type: string; [key: string]: unknown };\n  /** Embedding input text, set by the embeddings handler for fixture matching. */\n  embeddingInput?: string;\n  /** Endpoint type, set by handlers for fixture endpoint filtering. */\n  _endpointType?: string;\n  /** Context identifier, set by handlers for fixture context routing. */\n  _context?: string;\n  /**\n   * Video-provider discriminator, set by the async video handlers for journal\n   * and dispatch clarity only. NOT a fixture match key — `buildFixtureMatch`\n   * derives the endpoint from `_endpointType` and never reads this field; the\n   * model string is the provider disambiguator (veo-* / grok-imagine-* /\n   * openrouter ids do not overlap).\n   */\n  _videoProvider?: \"openrouter\" | \"veo\" | \"grok\" | \"byteplus\";\n  [key: string]: unknown;\n}\n\nexport interface ToolDefinition {\n  type: \"function\";\n  function: { name: string; description?: string; parameters?: object };\n}\n\n// Fixture matching\n\nexport interface FixtureMatch {\n  userMessage?: string | RegExp;\n  /**\n   * Substring, regexp, or array of substrings matched against the concatenated\n   * text content of every `system` role message in the request. Gates fixture\n   * activation on values the host plumbs in via system messages (agent\n   * context, persona, dynamic config) instead of the user-typed prompt — so\n   * changing context state in the calling app causes stale fixtures to fall\n   * through to a real upstream instead of silently returning a baked response\n   * that no longer reflects reality.\n   *\n   * When given an array of strings, ALL substrings must be present (AND\n   * semantics). Useful when the gate must combine multiple non-adjacent\n   * tokens — e.g., a default name AND a default activity list whose JSON\n   * positions vary across requests.\n   */\n  systemMessage?: string | string[] | RegExp;\n  inputText?: string | RegExp;\n  toolCallId?: string;\n  /**\n   * Substring matched against the text content of the LAST message when that\n   * message is a `tool` result (same last-message rule as `toolCallId`).\n   * Discriminates fixtures whose requests differ ONLY inside the tool-result\n   * payload — e.g. a human-in-the-loop tool where approve and cancel resume\n   * with the same toolCallId but different result JSON.\n   */\n  toolResultContains?: string;\n  toolName?: string;\n  model?: string | RegExp;\n  responseFormat?: string;\n  predicate?: (req: ChatCompletionRequest) => boolean;\n  /** Which occurrence of this match to respond to (0-indexed). Undefined means match any. */\n  sequenceIndex?: number;\n  turnIndex?: number;\n  /**\n   * Turn-scoped tool-result presence gate: matches on whether the CURRENT turn\n   * (the messages after the last `role: \"user\"` message) contains a `role: \"tool\"`\n   * message. Scoping to the current turn — rather than the whole conversation —\n   * lets a leg-1 (`false`) / leg-2 (`true`) fixture pair keep discriminating on\n   * later turns whose history still carries earlier turns' tool results. If the\n   * request has no user message, it falls back to scanning the whole conversation.\n   */\n  hasToolResult?: boolean;\n  endpoint?:\n    | \"chat\"\n    | \"image\"\n    | \"speech\"\n    | \"transcription\"\n    | \"translation\"\n    | \"video\"\n    | \"embedding\"\n    | \"audio-gen\"\n    | \"elevenlabs-tts\"\n    | \"elevenlabs-voice-design\"\n    | \"elevenlabs-voice\"\n    | \"elevenlabs-voice-get\"\n    | \"elevenlabs-voice-delete\"\n    | \"fal-audio\"\n    | \"fal\"\n    | \"realtime\"\n    | \"realtime-transcription\"\n    | \"realtime-translation\"\n    | \"openai-live\";\n  context?: string;\n}\n\n// Fixture response types\n\n/**\n * Fields that override auto-generated envelope values in the built response.\n * Scalar fields (finishReason, role) use OpenAI-canonical values — provider\n * handlers translate automatically. For usage, provide field names native to\n * your target provider (OpenAI Chat: prompt_tokens, completion_tokens;\n * Responses API: input_tokens, output_tokens; Anthropic: input_tokens,\n * output_tokens; Gemini: promptTokenCount, candidatesTokenCount).\n *\n * When total_tokens (or provider equivalent) is omitted, it is auto-computed\n * from the component fields.\n *\n * Provider support: seven fields are common (id, created, model, usage,\n * systemFingerprint, finishReason, role); provider and nativeFinishReason are\n * OpenRouter-only and ignored elsewhere. OpenAI Chat honors the seven common\n * fields; OpenRouter additionally honors provider/nativeFinishReason; Responses\n * API (5: no role, systemFingerprint); Claude (5: no created,\n * systemFingerprint); Gemini (2: only finishReason, usage).\n */\nexport interface ResponseOverrides {\n  id?: string;\n  created?: number;\n  model?: string;\n  usage?: {\n    prompt_tokens?: number;\n    completion_tokens?: number;\n    total_tokens?: number;\n    input_tokens?: number;\n    output_tokens?: number;\n    promptTokenCount?: number;\n    candidatesTokenCount?: number;\n    totalTokenCount?: number;\n    /**\n     * OpenRouter per-request cost (USD/credits). Fixture-scriptable — powers\n     * budget-guard demos (\"assert the guard trips at $5 without spending $5\").\n     * Emitted on OpenRouter-shaped responses only, and ONLY when supplied —\n     * `cost`/`cost_details` are nullable and omitted by default (never 0).\n     */\n    cost?: number;\n    /**\n     * OpenRouter cost breakdown. When the response emits `cost_details` at all\n     * it MUST carry all three upstream fields (the canonical `@openrouter/sdk`\n     * throws on a partial object); a fixture may supply any subset and the rest\n     * default to 0. Only emitted when the fixture supplies a `cost`.\n     */\n    cost_details?: {\n      upstream_inference_cost?: number;\n      upstream_inference_prompt_cost?: number;\n      upstream_inference_completions_cost?: number;\n      [key: string]: unknown;\n    };\n    /**\n     * OpenRouter prompt-token breakdown. Emitted ONLY when overridden — the\n     * default response never asserts a fake cache state.\n     */\n    prompt_tokens_details?: {\n      cached_tokens?: number;\n      cache_write_tokens?: number;\n      audio_tokens?: number;\n      [key: string]: unknown;\n    };\n    /**\n     * OpenRouter completion-token breakdown. Emitted ONLY when overridden.\n     */\n    completion_tokens_details?: { reasoning_tokens?: number; [key: string]: unknown };\n    /**\n     * OpenRouter bring-your-own-key flag on the usage object. Emitted ONLY when\n     * overridden (avoids asserting a fake BYOK state by default).\n     */\n    is_byok?: boolean;\n    /**\n     * Forward-compat escape hatch for provider usage fields aimock does not\n     * model (OpenRouter `native_tokens_prompt` / `native_tokens_completion`,\n     * future breakdowns, …). The recorder persists such fields when an upstream\n     * usage frame carries them, and OpenRouter-shaped replays pass any extra key\n     * through verbatim onto the emitted `usage` object. The load-time validator\n     * still requires extra scalars to be numbers (see fixture-loader.ts), so a\n     * typo'd field is caught rather than silently emitted as a string.\n     */\n    [key: string]: unknown;\n  };\n  systemFingerprint?: string;\n  finishReason?: string;\n  role?: string;\n  /**\n   * OpenRouter top-level `provider` override. When omitted, OpenRouter-shaped\n   * responses default it to the author segment of the winning model slug\n   * (`openai/gpt-4o` → `\"openai\"`). Ignored for OpenAI (`/v1/...`) responses.\n   */\n  provider?: string;\n  /**\n   * OpenRouter `native_finish_reason` override (the raw upstream finish reason).\n   * When omitted, OpenRouter-shaped responses mirror `finish_reason`. Ignored\n   * for OpenAI responses.\n   */\n  nativeFinishReason?: string;\n}\n\nexport interface TextResponse extends ResponseOverrides {\n  content: string;\n  reasoning?: string;\n  /**\n   * The real cryptographic `signature` captured from a recorded Anthropic\n   * thinking turn. When present it is emitted on the replayed thinking block;\n   * otherwise replay falls back to aimock's round-trip-safe placeholder.\n   * Persisted only alongside a non-empty `reasoning`: a signature captured\n   * without plaintext reasoning (e.g. whitespace-only thinking) is intentionally\n   * discarded at the persistence layer, since replay attaches signatures only to\n   * plaintext thinking blocks.\n   */\n  reasoningSignature?: string;\n  /**\n   * Opaque `data` payload(s) of any Anthropic `redacted_thinking` blocks\n   * captured from a recorded thinking turn, in stream order. When present they\n   * are replayed as faithful `redacted_thinking` content blocks so the encrypted\n   * reasoning round-trips; absent for non-Anthropic providers and turns without\n   * redacted thinking. Recorded redacted blocks replay as a leading group: the\n   * original interleaving of `thinking` and `redacted_thinking` blocks is not\n   * preserved (see the CHANGELOG fidelity caveat).\n   */\n  redactedThinking?: string[];\n  webSearches?: string[];\n}\n\nexport interface ToolCall {\n  name: string;\n  arguments: string;\n  id?: string;\n}\n\n/**\n * A single ordered streaming block for a {@link ContentWithToolCallsResponse}.\n *\n * When a combined content+toolCalls fixture sets the optional `blocks` field,\n * builders stream the blocks in array order — enabling tool-call-before-text\n * and interleaved orderings that the legacy `{ content, toolCalls }` shape\n * (always text-first) cannot express. A `text` block carries a text segment; a\n * `toolCall` block mirrors {@link ToolCall} (`name` + JSON-string `arguments`,\n * optional `id`).\n */\nexport type FixtureBlock =\n  | { type: \"text\"; text: string }\n  | { type: \"toolCall\"; name: string; arguments: string; id?: string };\n\nexport interface ToolCallResponse extends ResponseOverrides {\n  toolCalls: ToolCall[];\n  reasoning?: string;\n  /** Real Anthropic thinking-block signature; see {@link TextResponse.reasoningSignature}. */\n  reasoningSignature?: string;\n  /** Anthropic redacted_thinking block data; see {@link TextResponse.redactedThinking}. */\n  redactedThinking?: string[];\n  webSearches?: string[];\n}\n\nexport interface ContentWithToolCallsResponse extends ResponseOverrides {\n  /**\n   * Combined-turn text. Required for the legacy `{ content, toolCalls }` shape\n   * and the combined `{ content, toolCalls, blocks }` shape. OPTIONAL only for a\n   * BLOCKS-ONLY fixture (`{ blocks: [...] }` with no `content`/`toolCalls`),\n   * where the ordered `blocks` array is the sole source of streamed output and\n   * the legacy text-first builder branch is never taken. The runtime guard\n   * `isContentWithToolCallsResponse` enforces this: it matches when BOTH\n   * `content` + `toolCalls` are present (legacy/combined) OR when a non-empty\n   * `blocks` array is present (blocks-only).\n   */\n  content?: string;\n  /** See {@link ContentWithToolCallsResponse.content} — optional only for the blocks-only shape. */\n  toolCalls?: ToolCall[];\n  /**\n   * Optional ordered streaming blocks. When present, builders stream these in\n   * array order (tool-first / interleaved); when absent, the legacy\n   * `{ content, toolCalls }` text-first path runs unchanged. Purely additive.\n   * A non-empty `blocks` array also makes this a FIRST-CLASS blocks-only\n   * response even without `content`/`toolCalls` (see those fields above).\n   */\n  blocks?: FixtureBlock[];\n  reasoning?: string;\n  /** Real Anthropic thinking-block signature; see {@link TextResponse.reasoningSignature}. */\n  reasoningSignature?: string;\n  /** Anthropic redacted_thinking block data; see {@link TextResponse.redactedThinking}. */\n  redactedThinking?: string[];\n  webSearches?: string[];\n}\n\nexport interface ErrorResponse {\n  error: {\n    message: string;\n    type?: string;\n    param?: string | null;\n    code?: string;\n    /**\n     * OpenRouter error metadata. Emitted verbatim inside the OpenRouter error\n     * envelope (`{ error: { code, message, metadata } }`) when the request\n     * arrived on the OpenRouter base. Moderation blocks carry\n     * `{ reasons, flagged_input, provider_name, model_slug }` on a 403.\n     * Ignored for OpenAI-shaped error responses.\n     */\n    metadata?: Record<string, unknown>;\n  };\n  status?: number;\n  /** Override the Retry-After header value on 429 responses. Default: 1. */\n  retryAfter?: number;\n  /**\n   * OpenRouter `models[]` failover eligibility for THIS error class. Real\n   * OpenRouter fails over INCONSISTENTLY by error class — a `403 budget-exceeded`\n   * or a generic \"provider returned error\" is served as terminal (it does NOT\n   * advance to the next `models[]` candidate), while 429/503 usually do fail\n   * over (openclaw #60191). This flag lets a fixture reproduce that:\n   * - absent / `true` (default) — the error candidate FALLS THROUGH to the next\n   *   `models[]` candidate (backward-compatible; existing fixtures unchanged).\n   * - `false` — the error is TERMINAL: the fallback loop stops and serves this\n   *   error with no failover, even if a later candidate would match.\n   *\n   * Composes with the request-level `provider.allow_fallbacks`: fall-through\n   * happens only when BOTH allow it (if EITHER says don't, don't). Only\n   * consulted for OpenRouter `models[]` fallback; ignored elsewhere.\n   */\n  fallthrough?: boolean;\n}\n\nexport interface EmbeddingResponse {\n  embedding: number[];\n}\n\nexport interface ImageItem {\n  url?: string;\n  b64Json?: string;\n  revisedPrompt?: string;\n}\n\nexport interface ImageResponse {\n  image?: ImageItem;\n  images?: ImageItem[];\n}\n\n// ORDERING CONTRACT: audio fixtures MUST be discriminated by `isAudioResponse`\n// BEFORE the `isContentWithToolCallsResponse` / `isToolCallResponse` / text\n// guards, because the optional companion fields below make these shapes\n// structurally overlap (an AudioResponse with `toolCalls`/`content` would also\n// satisfy those guards otherwise).\nexport interface VoiceDesignPreview {\n  generated_voice_id: string;\n  // Optional like its siblings below: `voiceDesignToJson` substitutes `\"\"`\n  // when it is absent, so requiring it here made that documented fallback\n  // unreachable from TypeScript.\n  audio_base_64?: string;\n  media_type?: string;\n  duration_secs?: number;\n  language?: string | null;\n}\n\n/**\n * Convenience shape for `LLMock.onElevenLabsVoiceDesign`. Stored as a\n * {@link RawJSONResponse} wrapping `{ previews, text }` — the ElevenLabs\n * `/v1/text-to-voice/design` envelope.\n */\nexport interface VoiceDesignResponse {\n  previews: VoiceDesignPreview[];\n  text?: string;\n}\n\nexport interface AudioResponse {\n  audio: string | { b64Json: string; contentType?: string };\n  format?: string;\n  /**\n   * Companion modalities that can accompany streamed audio. A single Gemini turn\n   * may interleave inlineData audio with a functionCall and/or text/thought\n   * parts; the recorder preserves them here so the tool call / content / reasoning\n   * are not silently discarded when audio is also present.\n   */\n  toolCalls?: ToolCall[];\n  content?: string;\n  reasoning?: string;\n}\n\nexport interface TranscriptionResponse {\n  transcription: {\n    text: string;\n    language?: string;\n    languages?: Array<{ code: string }>;\n    duration?: number;\n    usage?: Record<string, unknown>;\n    words?: Array<{ word: string; start: number; end: number }>;\n    segments?: Array<{ id: number; text: string; start: number; end: number }>;\n  };\n}\n\nexport interface VideoResponse {\n  video: {\n    id: string;\n    status: \"processing\" | \"completed\" | \"failed\";\n    url?: string;\n    /** Failure message surfaced by async video jobs (e.g. OpenRouter `error`). */\n    error?: string;\n    /** Base64-encoded video bytes served by content-download endpoints. */\n    b64?: string;\n    /** Generation cost surfaced in usage envelopes (e.g. OpenRouter `usage.cost`). */\n    cost?: number;\n    /** Clip duration in seconds surfaced by some providers (e.g. Grok `video.duration`). */\n    duration?: number;\n  };\n}\n\n/**\n * Pass-through JSON response. Used by handlers (e.g. fal.ai) that record\n * arbitrary upstream JSON payloads and replay them verbatim, without the\n * provider-specific shape coercion the other response types impose.\n */\nexport interface RawJSONResponse extends ResponseOverrides {\n  json: unknown;\n  status?: number;\n  /**\n   * Billed quantity surfaced on the completed fal `queue-result` response via\n   * the `x-fal-billable-units` header (emitted alongside `x-fal-request-id` on\n   * the completed result). Real fal sets this header on its queue responses;\n   * recent versions of `@tanstack/ai-fal` read it to populate a consumer-side\n   * billed-units field (e.g. `usage.unitsBilled`). Omit it to preserve the\n   * header-less default — present only to let a fixture opt into exercising a\n   * consumer's cost/billing accounting path on replay.\n   */\n  billableUnits?: number;\n}\n\nexport type FixtureResponse =\n  | TextResponse\n  | ToolCallResponse\n  | ContentWithToolCallsResponse\n  | ErrorResponse\n  | EmbeddingResponse\n  | ImageResponse\n  | AudioResponse\n  | TranscriptionResponse\n  | VideoResponse\n  | RawJSONResponse\n  | LiveFixtureResponse;\n\n// GA Realtime session types\n\nexport type RealtimePhase = \"final_answer\" | \"commentary\";\n\nexport interface GASessionAudioConfig {\n  voice: string | null;\n  input_audio_format: { type: string; rate?: number; [key: string]: unknown } | null;\n  output_audio_format: { type: string; rate?: number; [key: string]: unknown } | null;\n  input_audio_noise_reduction: { type: string } | null;\n  input_audio_transcription: { model: string } | null;\n}\n\nexport interface GASessionConfig {\n  model: string;\n  modalities: string[];\n  instructions: string;\n  tools: unknown[];\n  temperature: number;\n  max_response_output_tokens: number | \"inf\";\n  audio: GASessionAudioConfig;\n  turn_detection: unknown | null;\n  input_audio_transcription: { model: string } | null;\n  type: \"conversation\" | \"transcription\" | \"translation\";\n  reasoning: { effort: string } | null;\n}\n\n// Streaming physics\n\nexport interface StreamingProfile {\n  ttft?: number; // Time to first token (ms)\n  tps?: number; // Tokens per second\n  jitter?: number; // Random variance factor (0-1), default 0\n}\n\n/**\n * Per-frame arrival timestamps captured during proxy recording.\n * Used during replay to reproduce real-world streaming timing instead of\n * the synthetic model (StreamingProfile / flat latency).\n */\nexport interface RecordedTimings {\n  ttftMs: number;\n  interChunkDelaysMs: number[];\n  totalDurationMs: number;\n}\n\n/**\n * Probabilistic chaos injection rates.\n *\n * Rates are evaluated sequentially per request — drop → malformed → rateLimit\n * → disconnect — as four separate draws in that order, and the first draw that\n * hits wins and short-circuits the rest. Each rate is therefore the probability\n * that its OWN draw hits GIVEN that no earlier rate fired, not the share of\n * requests that end in that fault; only `dropRate`, first in the chain, is\n * unconditional. A config of `{ dropRate: 0.5, malformedRate: 0.5 }` yields a\n * ~25 % effective malformed rate, not 50 %, and the same compounding applies to\n * `{ dropRate: 0.5, rateLimitRate: 0.5 }` (~25 % rate limits).\n */\n/**\n * Probabilistic (and one deterministic) fault injection knobs.\n *\n * VALIDATION — ONE policy, whatever the source. Each field is a finite number\n * in its range: the rates in [0, 1], `latencyMs` in [0, 30000]. A value outside\n * it, or one that is not a number at all (`\"0.5abc\"`, `\"Infinity\"`, `NaN`), is\n * REJECTED, never clamped — silent clamping substitutes a fault rate nobody\n * asked for and hides the misconfiguration that produced it.\n *\n * Rejection is reported in the loudest way each source allows, and the three\n * agree: `POST /__aimock/chaos` answers 400, the `--chaos-*` CLI flags refuse\n * to start, and a per-request header or a fixture/server value is refused with\n * a `[chaos]` warning and left unset so the next level of precedence (header >\n * fixture > server) applies.\n */\nexport interface ChaosConfig {\n  dropRate?: number;\n  malformedRate?: number;\n  disconnectRate?: number;\n  /**\n   * Deterministic delay (ms) injected before the request is handled.\n   * Applied when > 0 — header > fixture > server precedence, same as rates.\n   * Unlike rates it is not probabilistic: a set latency always fires so\n   * timeout/retry suites get a stable signal. Must be in [0, 30000]; a value\n   * outside that range is rejected, not clamped (see above).\n   */\n  latencyMs?: number;\n  /**\n   * Chance of a 429 rate-limit rejection with `Retry-After`, CONDITIONAL on\n   * neither `dropRate` nor `malformedRate` having fired first: it is the third\n   * draw in the drop → malformed → rateLimit → disconnect order, and the first\n   * hit wins. Paired with a 0.5 `dropRate` a 0.5 `rateLimitRate` produces ~25 %\n   * rate limits, not 50 % (see the interface docstring above).\n   */\n  rateLimitRate?: number;\n}\n\n/**\n * Server-level chaos as the handlers see it: a baseline plus per-`X-Test-Id`\n * overrides installed at runtime via `POST /__aimock/chaos`.\n *\n * Chaos is the LAST link in the precedence chain (request headers > fixture >\n * server), and this makes that last link test-scoped, the way every other\n * mutable axis in aimock is (fixture match-counts, video job maps). Under the\n * shipped topology — one shared `aimock` process serving a parallel suite — a\n * purely global switch would mean one test's chaos failing every other test.\n *\n * Scoping is by testId on BOTH sides: the traffic being evaluated and the\n * control request that installed the override. Both resolve the tag the way\n * `getTestId` does — the `X-Test-Id` header, else `?testId=` in the query\n * string — so a harness that can only tag one of those two ways still lands in\n * the same scope on both sides, and the two can never silently disagree.\n */\nexport interface ChaosScope {\n  /** Server-wide baseline: the construction config, or the untagged override. */\n  base?: ChaosConfig;\n  /**\n   * Per-testId overrides, consulted INSTEAD OF `base` — never merged over it.\n   *\n   * An installed override REPLACES the baseline wholesale for that testId: a\n   * server started with `--chaos-latency 500` whose test `t1` installs\n   * `{ dropRate: 1 }` gives `t1` traffic a drop and NO latency, because\n   * `latencyMs` is not restated. To keep a baseline field, restate it in the\n   * override body.\n   *\n   * Replacement — not a field-wise merge — is deliberate, and it is what makes\n   * `POST /__aimock/chaos {}` (\"explicitly no chaos for my test\") different\n   * from `DELETE /__aimock/chaos` (\"forget I said anything, fall back to the\n   * baseline\"). Under a merge, `POST {}` would be a no-op and that distinction\n   * would collapse. It also matches the untagged case, where an override\n   * likewise replaces the construction-time config rather than layering on it.\n   *\n   * The two chain links ABOVE this one — fixture chaos over server chaos, and\n   * request headers over both — DO merge field-wise (see `resolveChaosConfig`).\n   * Only the scope lookup replaces, because it selects a config rather than\n   * refining one. `GET /__aimock/chaos` with the same testId always reports the\n   * config actually in effect for that scope, so the replacement is auditable.\n   */\n  byTestId?: ReadonlyMap<string, ChaosConfig>;\n}\n\n/**\n * What `evaluateChaos` / `applyChaos` accept as server defaults. A plain\n * `ChaosConfig` still works (it is what external callers pass); the server\n * itself passes a `ChaosScope`.\n */\nexport type ChaosDefaults = ChaosConfig | ChaosScope;\n\nexport type ChaosAction = \"drop\" | \"malformed\" | \"rateLimit\" | \"disconnect\";\n\n// Response factory — allows dynamic fixture responses based on the incoming request\n\nexport type ResponseFactory = (\n  req: ChatCompletionRequest,\n) => FixtureResponse | Promise<FixtureResponse>;\n\n// Fixture\n\nexport interface Fixture {\n  match: FixtureMatch;\n  response: FixtureResponse | ResponseFactory;\n  latency?: number;\n  chunkSize?: number;\n  truncateAfterChunks?: number;\n  disconnectAfterMs?: number;\n  streamingProfile?: StreamingProfile;\n  recordedTimings?: RecordedTimings;\n  replaySpeed?: number;\n  chaos?: ChaosConfig;\n  /**\n   * Opt into OpenRouter's `: OPENROUTER PROCESSING` SSE keepalive comment\n   * lines on this fixture's streamed OpenRouter responses (default OFF).\n   * A faithful client skips `:`-prefixed lines before JSON-parsing; enabling\n   * this exercises that path. No effect on non-streaming or OpenAI responses.\n   */\n  openRouterProcessing?: boolean;\n  metadata?: {\n    systemHash?: string;\n    toolsHash?: string;\n  };\n}\n\nexport type FixtureOpts = Omit<Fixture, \"match\" | \"response\">;\nexport type EmbeddingFixtureOpts = Pick<FixtureOpts, \"latency\" | \"chaos\">;\n/**\n * Options for the fal queue/run fixture builders. Adds `billableUnits`, which\n * is emitted as the `x-fal-billable-units` header on the completed\n * `queue-result` response (see {@link RawJSONResponse.billableUnits}).\n */\nexport type FalQueueOpts = FixtureOpts & { billableUnits?: number };\n\n// Fixture file format (JSON on disk)\n//\n// File-entry types are intentionally relaxed compared to their runtime\n// counterparts so that fixture authors can write JSON objects where the\n// API ultimately expects a JSON *string*.  The fixture loader auto-\n// stringifies these before building the runtime Fixture.\n\nexport interface FixtureFileToolCall {\n  name: string;\n  /** Accepts a JSON object or array for convenience — the loader will JSON.stringify it. */\n  arguments: string | Record<string, unknown> | unknown[];\n  id?: string;\n}\n\n/**\n * On-disk counterpart of {@link FixtureBlock}. A `toolCall` block's\n * `arguments` is relaxed exactly like {@link FixtureFileToolCall} so authors\n * may write a JSON object/array; the loader JSON.stringifies it into the\n * runtime string form. Normalizes to a {@link FixtureBlock}.\n */\nexport type FixtureFileBlock =\n  | { type: \"text\"; text: string }\n  | {\n      type: \"toolCall\";\n      name: string;\n      /** Accepts a JSON object or array for convenience — the loader will JSON.stringify it. */\n      arguments: string | Record<string, unknown> | unknown[];\n      id?: string;\n    };\n\nexport interface FixtureFileToolCallResponse extends ResponseOverrides {\n  toolCalls: FixtureFileToolCall[];\n  reasoning?: string;\n  /** Real Anthropic thinking-block signature; see {@link TextResponse.reasoningSignature}. */\n  reasoningSignature?: string;\n  /** Anthropic redacted_thinking block data; see {@link TextResponse.redactedThinking}. */\n  redactedThinking?: string[];\n  webSearches?: string[];\n}\n\nexport interface FixtureFileTextResponse extends ResponseOverrides {\n  /** Accepts a JSON object or array (structured output) — the loader will JSON.stringify it. */\n  content: string | Record<string, unknown> | unknown[];\n  reasoning?: string;\n  /** Real Anthropic thinking-block signature; see {@link TextResponse.reasoningSignature}. */\n  reasoningSignature?: string;\n  /** Anthropic redacted_thinking block data; see {@link TextResponse.redactedThinking}. */\n  redactedThinking?: string[];\n  webSearches?: string[];\n}\n\nexport interface FixtureFileContentWithToolCallsResponse extends ResponseOverrides {\n  /**\n   * Accepts a JSON object or array (structured output) — the loader will\n   * JSON.stringify it. OPTIONAL only for a BLOCKS-ONLY fixture (mirrors\n   * {@link ContentWithToolCallsResponse.content}); required for the\n   * legacy/combined shapes.\n   */\n  content?: string | Record<string, unknown> | unknown[];\n  /** See {@link FixtureFileContentWithToolCallsResponse.content} — optional only for the blocks-only shape. */\n  toolCalls?: FixtureFileToolCall[];\n  /**\n   * Optional ordered streaming blocks (mirrors the in-memory\n   * {@link ContentWithToolCallsResponse.blocks}). When present, builders stream\n   * these in array order (tool-first / interleaved); a `toolCall` block's\n   * object `arguments` is auto-stringified just like `toolCalls[].arguments`.\n   * Absent → legacy text-first path runs unchanged. Purely additive. Uses the\n   * on-disk {@link FixtureFileBlock} shape with relaxed `arguments`. A non-empty\n   * `blocks` array alone makes this a first-class blocks-only fixture.\n   */\n  blocks?: FixtureFileBlock[];\n  reasoning?: string;\n  /** Real Anthropic thinking-block signature; see {@link TextResponse.reasoningSignature}. */\n  reasoningSignature?: string;\n  /** Anthropic redacted_thinking block data; see {@link TextResponse.redactedThinking}. */\n  redactedThinking?: string[];\n  webSearches?: string[];\n}\n\nexport type FixtureFileResponse =\n  | FixtureFileTextResponse\n  | FixtureFileToolCallResponse\n  | FixtureFileContentWithToolCallsResponse\n  | ErrorResponse\n  | EmbeddingResponse\n  | ImageResponse\n  | AudioResponse\n  | TranscriptionResponse\n  | VideoResponse\n  | RawJSONResponse\n  | LiveFixtureResponse;\n\nexport interface FixtureFile {\n  fixtures: FixtureFileEntry[];\n}\n\nexport interface FixtureFileEntry {\n  match: {\n    userMessage?: string;\n    /**\n     * String (single substring) or array of strings (all must be present).\n     * Mirrors the runtime FixtureMatch.systemMessage but without the RegExp\n     * form, which JSON cannot express.\n     */\n    systemMessage?: string | string[];\n    inputText?: string;\n    toolCallId?: string;\n    /**\n     * Substring matched against the last tool-result message's text content.\n     * Mirrors the runtime FixtureMatch.toolResultContains.\n     */\n    toolResultContains?: string;\n    toolName?: string;\n    model?: string;\n    responseFormat?: string;\n    sequenceIndex?: number;\n    turnIndex?: number;\n    /**\n     * Turn-scoped tool-result presence gate: matches on whether the CURRENT turn\n     * (the messages after the last `role: \"user\"` message) contains a `role: \"tool\"`\n     * message, not the whole conversation. Falls back to scanning the whole\n     * conversation when the request has no user message. Mirrors the runtime\n     * `FixtureMatch.hasToolResult`.\n     */\n    hasToolResult?: boolean;\n    endpoint?:\n      | \"chat\"\n      | \"image\"\n      | \"speech\"\n      | \"transcription\"\n      | \"translation\"\n      | \"video\"\n      | \"embedding\"\n      | \"audio-gen\"\n      | \"elevenlabs-tts\"\n      | \"elevenlabs-voice-design\"\n      | \"elevenlabs-voice\"\n      | \"elevenlabs-voice-get\"\n      | \"elevenlabs-voice-delete\"\n      | \"fal-audio\"\n      | \"fal\"\n      | \"realtime\"\n      | \"realtime-transcription\"\n      | \"realtime-translation\"\n      | \"openai-live\";\n    context?: string;\n    // predicate not supported in JSON files\n  };\n  response: FixtureFileResponse;\n  latency?: number;\n  chunkSize?: number;\n  truncateAfterChunks?: number;\n  disconnectAfterMs?: number;\n  streamingProfile?: StreamingProfile;\n  recordedTimings?: RecordedTimings;\n  replaySpeed?: number;\n  chaos?: ChaosConfig;\n  /** See {@link Fixture.openRouterProcessing}. */\n  openRouterProcessing?: boolean;\n  metadata?: {\n    systemHash?: string;\n    toolsHash?: string;\n  };\n}\n\n// Request journal\n\n/**\n * A recorded request body.\n *\n * Most journal entries carry a chat-completion request, but every service\n * journals through one entry type and several of them record a body that is\n * not one: the fine-tuning create payload is recorded verbatim so the journal\n * reports what the caller actually sent, and the journal's own size cap\n * substitutes a truncation marker for an oversized body. Neither shape has a\n * `model`/`messages` pair, so typing the field as `ChatCompletionRequest`\n * alone forces those writers through a cast that claims fields that are not\n * there — the second member exists so they do not have to lie.\n *\n * TypeScript collapses the two for ASSIGNMENT (`ChatCompletionRequest` has an\n * index signature, so it is itself a `Record<string, unknown>`); the union is\n * kept two-membered because it is what the field means, not because it narrows\n * anything. For READING, treat the body as opaque JSON — that is already how\n * every consumer uses it (the journal cap re-serializes it, `GET\n * /__aimock/journal` hands it back) — and property-check before reaching for a\n * chat-request field.\n */\nexport type JournalBody = ChatCompletionRequest | Record<string, unknown>;\n\nexport interface JournalEntry {\n  id: string;\n  timestamp: number;\n  method: string;\n  path: string;\n  headers: Record<string, string>;\n  body: JournalBody | null;\n  service?: string;\n  /**\n   * Resolved test id of an MCP request (`\"__default__\"` when none), for an\n   * MCP mount to set. Journal test-id filtering does not read it: it\n   * re-derives the id from the headers and path (`journalEntryTestId`).\n   */\n  testId?: string;\n  /** Resolved context of an MCP request, `null` when none; for an MCP mount to set. */\n  context?: string | null;\n  response: {\n    status: number;\n    fixture: Fixture | null;\n    /** For an MCP mount to set on `tools/call` entries a fake answered or failed. */\n    mcpFake?: { id: string | null; outcome: McpFakeOutcome };\n    /**\n     * What was going to serve this request. \"fixture\" = a fixture matched (or\n     * would have, before chaos intervened). \"proxy\" = no fixture matched and\n     * proxy was configured. \"internal\" = entries where the request was served\n     * by aimock's own synthetic logic — neither a matched fixture nor a\n     * configured proxy: chaos-path entries (e.g. chaos on the OpenRouter\n     * video lifecycle endpoints; in REPLAY mode their normal 200/400/401/404\n     * entries omit source, while record-mode 200s on those endpoints carry\n     * source:\"proxy\"), the OpenRouter video models listing synthesized as the\n     * fallback after a FAILED proxy attempt, and the services whose responses\n     * are synthesized outright — every fine-tuning entry carries it, success\n     * and error alike, since that store is aimock's own and no fixture or\n     * proxy ever serves it. Absent when the distinction doesn't apply\n     * (e.g. 404/503 fallback where nothing was going to serve).\n     */\n    source?: \"fixture\" | \"proxy\" | \"internal\";\n    interrupted?: boolean;\n    interruptReason?: string;\n    /**\n     * The handler crashed AFTER the response completed. The client received\n     * `status` in full, so this is not an interruption; the message is what\n     * the crash said.\n     */\n    error?: string;\n    chaosAction?: ChaosAction;\n    /** When the X-AIMock-Strict header overrode the server default. */\n    strictOverride?: boolean;\n  };\n}\n\n// SSE chunk types (OpenAI format)\n\n/**\n * OpenRouter-only additions layered onto a `usage` object when a response is\n * shaped for the OpenRouter `/api/v1/...` base. `cost`/`cost_details` are\n * NULLABLE and emitted only when a fixture supplies a cost (default: omitted).\n * When `cost_details` is emitted it carries all three upstream fields (partial\n * objects break the canonical SDK). The detail breakdowns and `is_byok` appear\n * only when a fixture overrides them; an emitted `prompt_tokens_details` always\n * carries `cached_tokens` and an emitted `completion_tokens_details` always\n * carries `reasoning_tokens` (required-if-present in the AI SDK provider).\n */\nexport interface OpenRouterUsageExtras {\n  cost?: number;\n  cost_details?: {\n    upstream_inference_cost: number;\n    upstream_inference_prompt_cost: number;\n    upstream_inference_completions_cost: number;\n    [key: string]: unknown;\n  };\n  prompt_tokens_details?: {\n    cached_tokens: number;\n    cache_write_tokens?: number;\n    audio_tokens?: number;\n    [key: string]: unknown;\n  };\n  completion_tokens_details?: { reasoning_tokens: number; [key: string]: unknown };\n  is_byok?: boolean;\n  /**\n   * Provider usage fields aimock does not model, passed through verbatim from a\n   * fixture's `response.usage` (typically written by the recorder from a real\n   * upstream usage frame — e.g. OpenRouter `native_tokens_prompt`).\n   */\n  [key: string]: unknown;\n}\n\nexport interface SSEChunk {\n  id: string;\n  object: \"chat.completion.chunk\";\n  created: number;\n  model: string;\n  choices: SSEChoice[];\n  /** Nullable: OpenRouter shaping emits this on every chunk (null when unset). */\n  system_fingerprint?: string | null;\n  usage?: {\n    prompt_tokens: number;\n    completion_tokens: number;\n    total_tokens: number;\n  } & OpenRouterUsageExtras;\n  /** OpenRouter top-level provider that served the chunk. OpenRouter shaping only. */\n  provider?: string;\n  /** OpenRouter emits `service_tier: null` on the final (usage-bearing) chunk. Shaping only. */\n  service_tier?: string | null;\n}\n\nexport interface SSEChoice {\n  index: number;\n  delta: SSEDelta;\n  logprobs: null;\n  finish_reason: string | null;\n  /** OpenRouter raw upstream finish reason, alongside the normalized one. */\n  native_finish_reason?: string | null;\n}\n\nexport interface SSEDelta {\n  role?: string;\n  content?: string | null;\n  reasoning_content?: string;\n  tool_calls?: SSEToolCallDelta[];\n}\n\nexport interface SSEToolCallDelta {\n  index: number;\n  id?: string;\n  type?: \"function\";\n  function?: { name?: string; arguments?: string };\n}\n\n// Non-streaming completion response types (OpenAI format)\n\nexport interface ChatCompletion {\n  id: string;\n  object: \"chat.completion\";\n  created: number;\n  model: string;\n  choices: ChatCompletionChoice[];\n  usage: {\n    prompt_tokens: number;\n    completion_tokens: number;\n    total_tokens: number;\n  } & OpenRouterUsageExtras;\n  /**\n   * Nullable: OpenRouter shaping always emits this on the non-streaming\n   * response (null when no override) because the canonical `@openrouter/sdk`\n   * requires the field. OpenAI responses omit it unless overridden.\n   */\n  system_fingerprint?: string | null;\n  /** OpenRouter top-level provider that served the request. OpenRouter shaping only. */\n  provider?: string;\n  /** OpenRouter emits `service_tier: null` on the non-streaming response. Shaping only. */\n  service_tier?: string | null;\n}\n\nexport interface ChatCompletionChoice {\n  index: number;\n  message: ChatCompletionMessage;\n  logprobs: null;\n  finish_reason: string;\n  /** OpenRouter raw upstream finish reason, alongside the normalized one. */\n  native_finish_reason?: string;\n}\n\nexport interface ChatCompletionMessage {\n  role: string;\n  content: string | null;\n  refusal: string | null;\n  reasoning_content?: string;\n  /**\n   * OpenRouter emits `reasoning` (null when absent) on the response message.\n   * OpenRouter shaping mirrors `reasoning_content` here (or null). Omitted for\n   * OpenAI responses.\n   */\n  reasoning?: string | null;\n  tool_calls?: ToolCallMessage[];\n}\n\n// Server options\n\nexport type RecordProviderKey =\n  | \"openai\"\n  | \"anthropic\"\n  | \"gemini\"\n  | \"gemini-interactions\"\n  | \"vertexai\"\n  | \"bedrock\"\n  | \"azure\"\n  | \"ollama\"\n  | \"cohere\"\n  | \"elevenlabs\"\n  | \"fal\"\n  | \"openrouter\"\n  | \"veo\"\n  | \"grok\"\n  | \"byteplus\";\n\nexport interface RecordConfig {\n  providers: Partial<Record<RecordProviderKey, string>>;\n  /**\n   * aimock's own built-in upstream API keys, keyed by provider. Opt-in and\n   * backward-compatible: when set for a provider, aimock injects the key on a\n   * fixture-miss passthrough IF the caller sent no credential or a dummy\n   * placeholder (see `applyProviderAuth`); a real caller key always overrides.\n   * Only static-key providers are eligible: OpenAI/OpenRouter/Cohere/Grok/BytePlus/Ollama\n   * (bearer), Anthropic (x-api-key), Gemini/Gemini-Interactions/Veo\n   * (x-goog-api-key), Azure OpenAI (api-key), ElevenLabs (xi-api-key), and fal\n   * (Authorization: Key). Signed/OAuth providers (Bedrock SigV4, Vertex AI\n   * OAuth) are never rewritten. Sourced from AIMOCK_PROVIDER_*_KEY env vars by\n   * the CLI (secrets stay out of `ps`).\n   */\n  providerKeys?: Partial<Record<RecordProviderKey, string>>;\n  fixturePath?: string;\n  /** Proxy unmatched requests without saving fixtures or caching in memory. */\n  proxyOnly?: boolean;\n  /**\n   * When true, record the exact model version string returned by the provider\n   * (e.g. \"gpt-4o-2024-08-06\") instead of stripping the date suffix to a\n   * canonical alias (e.g. \"gpt-4o\"). Default: false.\n   */\n  recordFullModelVersion?: boolean;\n  /**\n   * fal-specific recording knobs for the queue-walk recorder. During recording\n   * the queue handler POSTs submit, polls `status_url` until COMPLETED, then\n   * GETs `response_url` for the final job body — saved as the fixture. Tune\n   * the poll cadence and timeout here if upstream is unusually slow or fast.\n   */\n  fal?: FalRecordConfig;\n  /**\n   * OpenRouter-video-specific recording knobs for the live lifecycle proxy on\n   * `/api/v1/videos` (submit/poll proxied 1:1; completed jobs are captured\n   * eagerly as fixtures).\n   */\n  openRouterVideo?: OpenRouterVideoRecordConfig;\n  /**\n   * Connection idle timeout (ms) on the upstream request socket — fires if the\n   * socket is inactive for this duration at any point before the response body\n   * begins. Default: 30_000 (30s). Increase for upstreams with slow initial\n   * responses (reasoning models, queue-backed providers).\n   *\n   * Nuance on the OpenRouter video surface: the small-JSON lifecycle fetches\n   * (submit, status poll, models listing) apply this value as a TOTAL\n   * deadline on the whole fetch — indistinguishable from an idle timeout for\n   * envelope-sized bodies. The byte-bearing content fetches (eager capture,\n   * proxy-only content relay) gate only the response HEADERS on this value;\n   * their body progress is governed by `bodyTimeoutMs` idle semantics.\n   *\n   * Ceiling note: the fetch-based OpenRouter proxy paths run on Node's\n   * built-in undici dispatcher, which carries its own ~300s\n   * headers/body-timeout defaults — values above that ceiling do not take\n   * effect on those paths without installing a custom undici dispatcher\n   * (out of aimock's scope).\n   */\n  upstreamTimeoutMs?: number;\n  /**\n   * Idle timeout (ms) on the upstream response body — fires if the upstream\n   * goes silent (no bytes) for this long after the response has started.\n   * Default: 30_000 (30s). Reasoning models under concurrent load can leave\n   * 30s+ gaps between streaming chunks while the model is thinking; lift this\n   * to e.g. 180_000 in those setups. The OpenRouter video content fetches use\n   * the same idle semantics: the timer re-arms on every chunk, so a steadily\n   * downloading multi-minute video never times out — only a silent stall does.\n   */\n  bodyTimeoutMs?: number;\n  /**\n   * Maximum number of bytes aimock will accumulate in memory from a single\n   * proxied upstream response on the record/proxy path. The full response is\n   * still relayed to the client byte-for-byte; this cap only bounds the\n   * in-memory buffer used to collapse/journal the response. Once the cap is\n   * exceeded aimock stops appending to the buffer, marks the response as\n   * truncated, and skips collapse/recording — preventing both unbounded heap\n   * growth and the `RangeError: Invalid string length` that a >512MB string\n   * would otherwise throw. Default: 64 MiB.\n   */\n  maxProxyBufferBytes?: number;\n  /**\n   * Maximum number of SSE/NDJSON/EventStream frames whose per-frame state\n   * (`frameTimestamps`, parse buffers) aimock retains for a single proxied\n   * response. Frame state is count-indexed, not byte-sized, so a long-lived or\n   * never-ending stream accumulates it unbounded even when `maxProxyBufferBytes`\n   * is generous. Tripping truncation on EITHER bytes OR frame count bounds both;\n   * on the trip the accumulated frame state is freed and collapse/recording is\n   * skipped (the full response is still relayed to the client byte-for-byte).\n   * Default: 5,000,000 frames.\n   */\n  maxProxyBufferFrames?: number;\n}\n\nexport interface OpenRouterVideoRecordConfig {\n  /**\n   * Maximum decoded video size (bytes) embedded as `b64` in a recorded\n   * fixture. Captures larger than the cap are persisted WITHOUT `b64` (with a\n   * `_warning` in the fixture file) so a multi-hundred-MB video cannot bloat\n   * the fixture directory. The cap is also a memory guard: an upstream\n   * response that DECLARES an over-cap Content-Length is skipped without\n   * downloading, and a response with no declared length is streamed with the\n   * byte count enforced during the read — on exceed the download is aborted\n   * and nothing oversized is retained in memory. In both cases the\n   * same-session job serves the placeholder MP4. Default: 33554432 (32 MB\n   * decoded). Set 0 for unlimited. Negative or non-integer values are treated\n   * as the default (createServer warns at startup).\n   */\n  maxContentBytes?: number;\n}\n\nexport interface FalRecordConfig {\n  /** Interval between status polls upstream during recording. Default: 1000ms. */\n  pollIntervalMs?: number;\n  /** Total budget for an upstream queue walk before aborting. Default: 900000ms (15 min) to accommodate video generation. */\n  timeoutMs?: number;\n}\n\nexport interface MockServerOptions {\n  live?: LiveOptions;\n  /** Optional inbound test-client access keys. Omit to preserve permissive behavior. */\n  auth?: ApiKeyAuthConfig;\n  port?: number;\n  host?: string;\n  latency?: number;\n  chunkSize?: number;\n  replaySpeed?: number;\n  /** Log verbosity. CLI default is \"info\"; programmatic default (when omitted) is \"silent\". */\n  logLevel?: \"silent\" | \"warn\" | \"info\" | \"debug\";\n  chaos?: ChaosConfig;\n  /** Enable Prometheus-compatible /metrics endpoint. */\n  metrics?: boolean;\n  /** Strict mode: return 503 instead of 404 when no fixture matches. */\n  strict?: boolean;\n  /** Record-and-replay: proxy unmatched requests to upstream and save fixtures. */\n  record?: RecordConfig;\n  /**\n   * Maximum number of request/response entries to retain in the in-memory\n   * journal. Oldest entries are dropped FIFO when the cap is exceeded.\n   * Set to 0 (or omit) for unbounded retention. Negative values are\n   * rejected at the CLI parse layer; programmatically they are treated\n   * as 0 (unbounded) for back-compat.\n   *\n   * Default: 1000 (applied by `createServer` when omitted). The CLI passes\n   * through its own default. Short-lived test harnesses that want every\n   * request recorded can opt in to unbounded retention by passing 0.\n   */\n  journalMaxEntries?: number;\n  /**\n   * Maximum number of unique testIds retained in the journal's fixture\n   * match-count map. Oldest testIds are dropped FIFO when the cap is\n   * exceeded. Set to 0 (or omit) for unbounded retention. Negative values\n   * are rejected at the CLI parse layer; programmatically they are treated\n   * as 0 (unbounded) for back-compat.\n   *\n   * Default: 500 (applied by `createServer` when omitted). Without a cap\n   * this map can grow over time in long-running servers that see many\n   * unique testIds.\n   */\n  fixtureCountsMaxTestIds?: number;\n  /**\n   * Normalize requests before matching and recording. Useful for stripping\n   * dynamic data (timestamps, UUIDs, session IDs) that would cause fixture\n   * mismatches on replay.\n   *\n   * When set, string matching for `userMessage` and `inputText` uses exact\n   * equality (`===`) instead of substring (`includes`) to prevent false\n   * positives from shortened keys.\n   */\n  requestTransform?: (req: ChatCompletionRequest) => ChatCompletionRequest;\n  /**\n   * Configure fal.ai queue polling progression. By default a job completes\n   * on submit (preserves the legacy `COMPLETED`-on-submit shape). Opt into a\n   * realistic `IN_QUEUE → IN_PROGRESS → COMPLETED` progression by setting\n   * positive poll thresholds — useful for exercising client code that polls\n   * `/status` and reacts to intermediate states.\n   *\n   * Applies to the general fal handler (`x-fal-target-host`-routed); the\n   * legacy `/fal/queue/...` audio handler is unaffected.\n   */\n  falQueue?: FalQueueConfig;\n  /**\n   * Configure OpenRouter async video job polling progression\n   * (`pending → in_progress → completed | failed` on `GET /api/v1/videos/{id}`).\n   * Same threshold semantics as `falQueue`. By default (0/0) the job is\n   * seeded terminal at submit — content is downloadable with zero polls, and\n   * the first status poll merely reports the already-terminal status.\n   */\n  openRouterVideo?: FalQueueConfig;\n  /**\n   * Configure Google Veo async video job polling progression\n   * (`done:false → done:true` on `GET /v1beta/operations/{name}`). Same\n   * threshold semantics as `openRouterVideo`; the internal\n   * `pending → in_progress → completed | failed` model is serialized to the\n   * two-state Veo wire.\n   */\n  veoVideo?: FalQueueConfig;\n  /**\n   * Configure xAI Grok Imagine async video job polling progression\n   * (`pending → done | failed` on `GET /v1/videos/{request_id}`). Same\n   * threshold semantics as `openRouterVideo`; progress is synthesized from the\n   * poll count.\n   */\n  grokVideo?: FalQueueConfig;\n  /**\n   * Configure BytePlus Ark (Seedance) async video task polling progression\n   * (`queued → running → <recorded terminal status>` on\n   * `GET /api/v3/contents/generations/tasks/{id}`). Same threshold semantics as\n   * `grokVideo`; unlike the others the TERMINAL status is not synthesized — it\n   * is whatever the recorded/authored envelope carries.\n   */\n  bytePlusVideo?: FalQueueConfig;\n}\n\nexport interface ApiKeyAuthConfig {\n  apiKeys: readonly string[];\n}\n\n/**\n * Poll-progression thresholds, documented below in fal queue terms; when used\n * as `openRouterVideo` the states map to `pending` / `in_progress` /\n * `completed | failed`.\n */\nexport interface FalQueueConfig {\n  /**\n   * Status polls before transitioning `IN_QUEUE → IN_PROGRESS`. Unset and an\n   * explicit `0` differ: when BOTH fields are unset the job completes\n   * synchronously on submit (no IN_QUEUE / IN_PROGRESS polls emitted), but\n   * explicitly setting this field — even to `0` — enables progression when\n   * `pollsBeforeCompleted` is unset, with `pollsBeforeCompleted` defaulting\n   * to `pollsBeforeInProgress + 1` so the job passes through IN_PROGRESS\n   * (an explicit `pollsBeforeCompleted: 0` completes on submit only when\n   * `pollsBeforeInProgress` is `0` or unset — otherwise the clamp below\n   * lifts it to `pollsBeforeInProgress`).\n   */\n  pollsBeforeInProgress?: number;\n  /**\n   * Status polls before transitioning to `COMPLETED`. Default: 0 when\n   * `pollsBeforeInProgress` is also unset (no progression), otherwise\n   * `pollsBeforeInProgress + 1` so the job spends one poll in IN_PROGRESS.\n   * An explicit value lower than `pollsBeforeInProgress` is clamped up so\n   * IN_PROGRESS is never skipped. When equal to a nonzero\n   * `pollsBeforeInProgress` — or when `pollsBeforeInProgress` is unset or 0\n   * and this field is 1 (the IN_PROGRESS branch consumes the first poll) —\n   * the job still spends one poll in IN_PROGRESS, so the terminal status\n   * lands one poll later than configured.\n   */\n  pollsBeforeCompleted?: number;\n}\n\n// Handler defaults — the common shape passed from server.ts to every handler\n\nexport interface HandlerDefaults {\n  latency: number;\n  chunkSize: number;\n  replaySpeed: number;\n  logger: Logger;\n  /**\n   * Reads resolve to a `ChaosScope` on a real server (baseline + per-testId\n   * overrides); assigning `undefined` drops every runtime override.\n   */\n  chaos?: ChaosDefaults;\n  /**\n   * Live per-testId chaos overrides, owned by the server instance so the\n   * control API can install one without reaching through the getter.\n   */\n  chaosByTestId?: Map<string, ChaosConfig>;\n  registry?: MetricsRegistry;\n  record?: RecordConfig;\n  strict?: boolean;\n  requestTransform?: (req: ChatCompletionRequest) => ChatCompletionRequest;\n  falQueue?: FalQueueConfig;\n  openRouterVideo?: FalQueueConfig;\n  veoVideo?: FalQueueConfig;\n  grokVideo?: FalQueueConfig;\n  /**\n   * Configure BytePlus Ark (Seedance) async video task polling progression\n   * (`queued → running → <recorded terminal status>` on\n   * `GET /api/v3/contents/generations/tasks/{id}`). Same threshold semantics as\n   * `grokVideo`; unlike the others the TERMINAL status is not synthesized — it\n   * is whatever the recorded/authored envelope carries.\n   */\n  bytePlusVideo?: FalQueueConfig;\n}\n\n// MCP fakes — scenario-scoped MCP tool fakes in fixture files (`mcpFakes`)\n\n/**\n * Block scope: `\"shared\"`, or exact test id and/or context (at least one;\n * `{}` is not a scope). Readonly: validated scopes are frozen.\n */\nexport type McpFakeScope =\n  | \"shared\"\n  | Readonly<{ testId: string; context?: string }>\n  | Readonly<{ testId?: string; context: string }>;\n\n/**\n * `T` with every nested property and array read-only: the type of a value the\n * MCP fakes store deep-freezes before it hands it out.\n */\nexport type McpFakeDeepReadonly<T> = T extends (...args: never[]) => unknown\n  ? T\n  : T extends object\n    ? { readonly [K in keyof T]: McpFakeDeepReadonly<T[K]> }\n    : T;\n\n/** MCP `Annotations` on a content block. */\nexport interface McpFakeAnnotations {\n  audience?: Array<\"user\" | \"assistant\">;\n  /** From 0 (least) to 1 (most important). */\n  priority?: number;\n  /** RFC 3339 date-time with seconds and a `Z` or `±hh:mm` offset. */\n  lastModified?: string;\n}\n\n/** MCP `Icon` on a `resource_link` content block. */\nexport interface McpFakeIcon {\n  src: string;\n  mimeType?: string;\n  sizes?: string[];\n  theme?: \"light\" | \"dark\";\n}\n\n/** MCP `TextResourceContents` / `BlobResourceContents`: exactly one of `text` / `blob`. */\nexport type McpFakeResourceContents = {\n  uri: string;\n  mimeType?: string;\n  _meta?: Record<string, unknown>;\n} & ({ text: string; blob?: never } | { blob: string; text?: never });\n\ntype McpFakeContentCommon = {\n  annotations?: McpFakeAnnotations;\n  _meta?: Record<string, unknown>;\n};\n\n/** One MCP content block of a tool result (`ContentBlock`); `data` and `blob` are base64. */\nexport type McpFakeContentBlock = McpFakeContentCommon &\n  (\n    | { type: \"text\"; text: string }\n    | { type: \"image\"; data: string; mimeType: string }\n    | { type: \"audio\"; data: string; mimeType: string }\n    | {\n        type: \"resource_link\";\n        uri: string;\n        name: string;\n        title?: string;\n        description?: string;\n        mimeType?: string;\n        size?: number;\n        icons?: McpFakeIcon[];\n      }\n    | { type: \"resource\"; resource: McpFakeResourceContents }\n  );\n\n/** A full MCP `CallToolResult`, served unchanged. No other keys. */\nexport interface McpFakeFullResult {\n  content: McpFakeContentBlock[];\n  isError?: boolean;\n  structuredContent?: Record<string, unknown>;\n  _meta?: Record<string, unknown>;\n}\n\n/**\n * Structured data: any JSON object without the `CallToolResult`\n * keys, served as text plus `structuredContent`.\n */\nexport type McpFakeStructuredResult = Record<string, unknown> & {\n  content?: never;\n  isError?: never;\n  structuredContent?: never;\n  _meta?: never;\n};\n\n/**\n * A call entry's `result` value. Validation also checks what the type cannot\n * say: base64 `data` / `blob`, `priority` from 0 to 1, the `lastModified`\n * format, and plain JSON throughout. Unknown keys inside a content item are\n * allowed and served as given.\n */\nexport type McpFakeResult =\n  | string\n  | McpFakeContentBlock[]\n  | McpFakeFullResult\n  | McpFakeStructuredResult;\n\n/** How a call entry matches: exactly one of `args` / `anyArgs`. */\nexport type McpFakeCallMatch =\n  | { args: Record<string, unknown>; anyArgs?: never }\n  | { anyArgs: true; args?: never };\n\n/** What a call entry answers: exactly one of `result` / `error`. */\nexport type McpFakeCallAnswer =\n  | { result: McpFakeResult; error?: never }\n  | { error: string; result?: never };\n\n/** One ordered answer for a tool. */\nexport type McpFakeCall = McpFakeCallMatch & McpFakeCallAnswer & { id?: string };\n\n/** One faked tool in a block. */\nexport interface McpFakeTool {\n  name: string;\n  description?: string;\n  inputSchema?: Record<string, unknown>;\n  calls: McpFakeCall[];\n}\n\n/** One `mcpFakes` block. */\nexport interface McpFakeBlock {\n  scope: McpFakeScope;\n  mount?: string;\n  undeclaredTools?: McpFakeUndeclaredPolicy;\n  tools: McpFakeTool[];\n}\n\nexport type McpFakeUndeclaredPolicy = \"allow\" | \"deny\";\n\n/**\n * The resolved identity of one MCP request: test id, context and undeclared\n * override, each from the request or else from the session.\n * `null` means \"not supplied\". The identity shape the fake store's matching\n * methods take (`applicable`, `selectTier`, `claim`, `policy`, `declaredTools`,\n * `listTools`).\n */\nexport interface McpFakeIdentity {\n  testId: string | null;\n  context: string | null;\n  undeclared: McpFakeUndeclaredPolicy | null;\n}\n\n/**\n * One raw block as a loader hands it off, before validation. `source` is the\n * entry-id source string; `blockIndex` is `null` when `mcpFakes` is a single object.\n */\nexport interface McpFakeSource {\n  source: string;\n  blockIndex: number | null;\n  raw: unknown;\n}\n\n/**\n * `response.mcpFake.outcome` on a `tools/call` journal entry. `evicted`:\n * the request's test id lost its consumption state to the FIFO test-id cap.\n */\nexport type McpFakeOutcome = \"answered\" | \"mismatch\" | \"exhausted\" | \"not_declared\" | \"evicted\";\n\n/**\n * JSON-RPC error codes of the four fake failures, keyed by\n * `error.data.aimock.code`. `-31010` and `-31011` sit outside the JSON-RPC\n * reserved range. `MCP_FAKE_EVICTED` is for a lookup of a declared tool by a\n * test id whose state the FIFO test-id cap evicted, until it is reset.\n */\nexport const MCP_FAKE_ERROR_CODES = {\n  MCP_FAKE_NOT_DECLARED: -32602,\n  MCP_FAKE_MISMATCH: -32602,\n  MCP_FAKE_EXHAUSTED: -31010,\n  MCP_FAKE_EVICTED: -31011,\n} as const;\n\nexport type McpFakeErrorCode = keyof typeof MCP_FAKE_ERROR_CODES;\n"],"mappings":";;;;;;;;AA4gDA,MAAa,uBAAuB;CAClC,uBAAuB;CACvB,mBAAmB;CACnB,oBAAoB;CACpB,kBAAkB;CACnB"}

package/dist/types.d.cts

@@ -1,6 +1,8 @@
 import { Journal } from "./journal.cjs";
+import { LiveFixtureResponse, LiveOptions } from "./live-types.cjs";
 import { Logger } from "./logger.cjs";
 import { MetricsRegistry } from "./metrics.cjs";
+import { McpFakeAddOrigin, McpFakeAddResult } from "./mcp-fakes.cjs";
 import * as http$1 from "node:http";
 import * as net from "node:net";
 
@@ -15,6 +17,23 @@ interface Mountable {
   setJournal?(journal: Journal): void;
   setBaseUrl?(url: string): void;
   setRegistry?(registry: MetricsRegistry): void;
+  /**
+   * MCP fakes. A mount "is an MCPMock" for fakes if and only if it
+   * implements `addMcpFakes`. Always appends. `origin` picks the entry-id
+   * source and its counter: `file` keeps each block's `source` (`@<k>` load
+   * counter); `code` / `control-api` is one run-time addition (`code#<n>` /
+   * `control-api#<n>`). Returns the shadowed-entry warnings with the real
+   * entry ids. When any block is bad, or the input holds no blocks, throws one
+   * `FixtureLoadError` (an `McpFakesAddError` carrying every error found and
+   * the warnings) and adds nothing.
+   */
+  addMcpFakes?(blocks: McpFakeSource[], origin: McpFakeAddOrigin): McpFakeAddResult;
+  /** Unload every fake on this mount. The entry-id counters are kept. */
+  clearMcpFakes?(): void;
+  /** Reset fake consumption state for one test id, or for all when omitted. */
+  resetScenarioState?(testId?: string): void;
+  /** Hands an MCP mount a `Logger`. Nothing in the server calls it. */
+  setLogger?(logger: Logger): void;
 }
 interface ContentPart {
   type: string;
@@ -152,7 +171,7 @@ interface FixtureMatch {
    * request has no user message, it falls back to scanning the whole conversation.
    */
   hasToolResult?: boolean;
-  endpoint?: "chat" | "image" | "speech" | "transcription" | "translation" | "video" | "embedding" | "audio-gen" | "elevenlabs-tts" | "fal-audio" | "fal" | "realtime" | "realtime-transcription" | "realtime-translation";
+  endpoint?: "chat" | "image" | "speech" | "transcription" | "translation" | "video" | "embedding" | "audio-gen" | "elevenlabs-tts" | "elevenlabs-voice-design" | "elevenlabs-voice" | "elevenlabs-voice-get" | "elevenlabs-voice-delete" | "fal-audio" | "fal" | "realtime" | "realtime-transcription" | "realtime-translation" | "openai-live";
   context?: string;
 }
 /**
@@ -388,6 +407,22 @@ interface ImageResponse {
   image?: ImageItem;
   images?: ImageItem[];
 }
+interface VoiceDesignPreview {
+  generated_voice_id: string;
+  audio_base_64?: string;
+  media_type?: string;
+  duration_secs?: number;
+  language?: string | null;
+}
+/**
+ * Convenience shape for `LLMock.onElevenLabsVoiceDesign`. Stored as a
+ * {@link RawJSONResponse} wrapping `{ previews, text }` — the ElevenLabs
+ * `/v1/text-to-voice/design` envelope.
+ */
+interface VoiceDesignResponse {
+  previews: VoiceDesignPreview[];
+  text?: string;
+}
 interface AudioResponse {
   audio: string | {
     b64Json: string;
@@ -460,7 +495,7 @@ interface RawJSONResponse extends ResponseOverrides {
    */
   billableUnits?: number;
 }
-type FixtureResponse = TextResponse | ToolCallResponse | ContentWithToolCallsResponse | ErrorResponse | EmbeddingResponse | ImageResponse | AudioResponse | TranscriptionResponse | VideoResponse | RawJSONResponse;
+type FixtureResponse = TextResponse | ToolCallResponse | ContentWithToolCallsResponse | ErrorResponse | EmbeddingResponse | ImageResponse | AudioResponse | TranscriptionResponse | VideoResponse | RawJSONResponse | LiveFixtureResponse;
 interface StreamingProfile {
   ttft?: number;
   tps?: number;
@@ -479,16 +514,50 @@ interface RecordedTimings {
 /**
  * Probabilistic chaos injection rates.
  *
- * Rates are evaluated sequentially per request — drop → malformed → disconnect
- * — and the first hit wins. Consequently malformedRate is conditional on drop
- * not firing, and disconnectRate is conditional on neither drop nor malformed
- * firing. A config of `{ dropRate: 0.5, malformedRate: 0.5 }` yields a ~25 %
- * effective malformed rate, not 50 %.
+ * Rates are evaluated sequentially per request — drop → malformed → rateLimit
+ * → disconnect — as four separate draws in that order, and the first draw that
+ * hits wins and short-circuits the rest. Each rate is therefore the probability
+ * that its OWN draw hits GIVEN that no earlier rate fired, not the share of
+ * requests that end in that fault; only `dropRate`, first in the chain, is
+ * unconditional. A config of `{ dropRate: 0.5, malformedRate: 0.5 }` yields a
+ * ~25 % effective malformed rate, not 50 %, and the same compounding applies to
+ * `{ dropRate: 0.5, rateLimitRate: 0.5 }` (~25 % rate limits).
+ */
+/**
+ * Probabilistic (and one deterministic) fault injection knobs.
+ *
+ * VALIDATION — ONE policy, whatever the source. Each field is a finite number
+ * in its range: the rates in [0, 1], `latencyMs` in [0, 30000]. A value outside
+ * it, or one that is not a number at all (`"0.5abc"`, `"Infinity"`, `NaN`), is
+ * REJECTED, never clamped — silent clamping substitutes a fault rate nobody
+ * asked for and hides the misconfiguration that produced it.
+ *
+ * Rejection is reported in the loudest way each source allows, and the three
+ * agree: `POST /__aimock/chaos` answers 400, the `--chaos-*` CLI flags refuse
+ * to start, and a per-request header or a fixture/server value is refused with
+ * a `[chaos]` warning and left unset so the next level of precedence (header >
+ * fixture > server) applies.
  */
 interface ChaosConfig {
   dropRate?: number;
   malformedRate?: number;
   disconnectRate?: number;
+  /**
+   * Deterministic delay (ms) injected before the request is handled.
+   * Applied when > 0 — header > fixture > server precedence, same as rates.
+   * Unlike rates it is not probabilistic: a set latency always fires so
+   * timeout/retry suites get a stable signal. Must be in [0, 30000]; a value
+   * outside that range is rejected, not clamped (see above).
+   */
+  latencyMs?: number;
+  /**
+   * Chance of a 429 rate-limit rejection with `Retry-After`, CONDITIONAL on
+   * neither `dropRate` nor `malformedRate` having fired first: it is the third
+   * draw in the drop → malformed → rateLimit → disconnect order, and the first
+   * hit wins. Paired with a 0.5 `dropRate` a 0.5 `rateLimitRate` produces ~25 %
+   * rate limits, not 50 % (see the interface docstring above).
+   */
+  rateLimitRate?: number;
 }
 /**
  * Server-level chaos as the handlers see it: a baseline plus per-`X-Test-Id`
@@ -509,7 +578,28 @@ interface ChaosConfig {
 interface ChaosScope {
   /** Server-wide baseline: the construction config, or the untagged override. */
   base?: ChaosConfig;
-  /** Per-testId overrides, consulted before `base`. */
+  /**
+   * Per-testId overrides, consulted INSTEAD OF `base` — never merged over it.
+   *
+   * An installed override REPLACES the baseline wholesale for that testId: a
+   * server started with `--chaos-latency 500` whose test `t1` installs
+   * `{ dropRate: 1 }` gives `t1` traffic a drop and NO latency, because
+   * `latencyMs` is not restated. To keep a baseline field, restate it in the
+   * override body.
+   *
+   * Replacement — not a field-wise merge — is deliberate, and it is what makes
+   * `POST /__aimock/chaos {}` ("explicitly no chaos for my test") different
+   * from `DELETE /__aimock/chaos` ("forget I said anything, fall back to the
+   * baseline"). Under a merge, `POST {}` would be a no-op and that distinction
+   * would collapse. It also matches the untagged case, where an override
+   * likewise replaces the construction-time config rather than layering on it.
+   *
+   * The two chain links ABOVE this one — fixture chaos over server chaos, and
+   * request headers over both — DO merge field-wise (see `resolveChaosConfig`).
+   * Only the scope lookup replaces, because it selects a config rather than
+   * refining one. `GET /__aimock/chaos` with the same testId always reports the
+   * config actually in effect for that scope, so the replacement is auditable.
+   */
   byTestId?: ReadonlyMap<string, ChaosConfig>;
 }
 /**
@@ -518,7 +608,7 @@ interface ChaosScope {
  * itself passes a `ChaosScope`.
  */
 type ChaosDefaults = ChaosConfig | ChaosScope;
-type ChaosAction = "drop" | "malformed" | "disconnect";
+type ChaosAction = "drop" | "malformed" | "rateLimit" | "disconnect";
 type ResponseFactory = (req: ChatCompletionRequest) => FixtureResponse | Promise<FixtureResponse>;
 interface Fixture {
   match: FixtureMatch;
@@ -621,7 +711,7 @@ interface FixtureFileContentWithToolCallsResponse extends ResponseOverrides {
   redactedThinking?: string[];
   webSearches?: string[];
 }
-type FixtureFileResponse = FixtureFileTextResponse | FixtureFileToolCallResponse | FixtureFileContentWithToolCallsResponse | ErrorResponse | EmbeddingResponse | ImageResponse | AudioResponse | TranscriptionResponse | VideoResponse | RawJSONResponse;
+type FixtureFileResponse = FixtureFileTextResponse | FixtureFileToolCallResponse | FixtureFileContentWithToolCallsResponse | ErrorResponse | EmbeddingResponse | ImageResponse | AudioResponse | TranscriptionResponse | VideoResponse | RawJSONResponse | LiveFixtureResponse;
 interface FixtureFile {
   fixtures: FixtureFileEntry[];
 }
@@ -654,7 +744,7 @@ interface FixtureFileEntry {
      * `FixtureMatch.hasToolResult`.
      */
     hasToolResult?: boolean;
-    endpoint?: "chat" | "image" | "speech" | "transcription" | "translation" | "video" | "embedding" | "audio-gen" | "elevenlabs-tts" | "fal-audio" | "fal" | "realtime" | "realtime-transcription" | "realtime-translation";
+    endpoint?: "chat" | "image" | "speech" | "transcription" | "translation" | "video" | "embedding" | "audio-gen" | "elevenlabs-tts" | "elevenlabs-voice-design" | "elevenlabs-voice" | "elevenlabs-voice-get" | "elevenlabs-voice-delete" | "fal-audio" | "fal" | "realtime" | "realtime-transcription" | "realtime-translation" | "openai-live";
     context?: string;
   };
   response: FixtureFileResponse;
@@ -673,17 +763,51 @@ interface FixtureFileEntry {
     toolsHash?: string;
   };
 }
+/**
+ * A recorded request body.
+ *
+ * Most journal entries carry a chat-completion request, but every service
+ * journals through one entry type and several of them record a body that is
+ * not one: the fine-tuning create payload is recorded verbatim so the journal
+ * reports what the caller actually sent, and the journal's own size cap
+ * substitutes a truncation marker for an oversized body. Neither shape has a
+ * `model`/`messages` pair, so typing the field as `ChatCompletionRequest`
+ * alone forces those writers through a cast that claims fields that are not
+ * there — the second member exists so they do not have to lie.
+ *
+ * TypeScript collapses the two for ASSIGNMENT (`ChatCompletionRequest` has an
+ * index signature, so it is itself a `Record<string, unknown>`); the union is
+ * kept two-membered because it is what the field means, not because it narrows
+ * anything. For READING, treat the body as opaque JSON — that is already how
+ * every consumer uses it (the journal cap re-serializes it, `GET
+ * /__aimock/journal` hands it back) — and property-check before reaching for a
+ * chat-request field.
+ */
+type JournalBody = ChatCompletionRequest | Record<string, unknown>;
 interface JournalEntry {
   id: string;
   timestamp: number;
   method: string;
   path: string;
   headers: Record<string, string>;
-  body: ChatCompletionRequest | null;
+  body: JournalBody | null;
   service?: string;
+  /**
+   * Resolved test id of an MCP request (`"__default__"` when none), for an
+   * MCP mount to set. Journal test-id filtering does not read it: it
+   * re-derives the id from the headers and path (`journalEntryTestId`).
+   */
+  testId?: string;
+  /** Resolved context of an MCP request, `null` when none; for an MCP mount to set. */
+  context?: string | null;
   response: {
     status: number;
     fixture: Fixture | null;
+    /** For an MCP mount to set on `tools/call` entries a fake answered or failed. */
+    mcpFake?: {
+      id: string | null;
+      outcome: McpFakeOutcome;
+    };
     /**
      * What was going to serve this request. "fixture" = a fixture matched (or
      * would have, before chaos intervened). "proxy" = no fixture matched and
@@ -692,13 +816,22 @@ interface JournalEntry {
      * configured proxy: chaos-path entries (e.g. chaos on the OpenRouter
      * video lifecycle endpoints; in REPLAY mode their normal 200/400/401/404
      * entries omit source, while record-mode 200s on those endpoints carry
-     * source:"proxy") AND the OpenRouter video models listing synthesized as
-     * the fallback after a FAILED proxy attempt. Absent when the distinction
-     * doesn't apply (e.g. 404/503 fallback where nothing was going to serve).
+     * source:"proxy"), the OpenRouter video models listing synthesized as the
+     * fallback after a FAILED proxy attempt, and the services whose responses
+     * are synthesized outright — every fine-tuning entry carries it, success
+     * and error alike, since that store is aimock's own and no fixture or
+     * proxy ever serves it. Absent when the distinction doesn't apply
+     * (e.g. 404/503 fallback where nothing was going to serve).
      */
     source?: "fixture" | "proxy" | "internal";
     interrupted?: boolean;
     interruptReason?: string;
+    /**
+     * The handler crashed AFTER the response completed. The client received
+     * `status` in full, so this is not an interruption; the message is what
+     * the crash said.
+     */
+    error?: string;
     chaosAction?: ChaosAction;
     /** When the X-AIMock-Strict header overrode the server default. */
     strictOverride?: boolean;
@@ -938,6 +1071,7 @@ interface FalRecordConfig {
   timeoutMs?: number;
 }
 interface MockServerOptions {
+  live?: LiveOptions;
   /** Optional inbound test-client access keys. Omit to preserve permissive behavior. */
   auth?: ApiKeyAuthConfig;
   port?: number;
@@ -1097,7 +1231,176 @@ interface HandlerDefaults {
    */
   bytePlusVideo?: FalQueueConfig;
 }
-//# sourceMappingURL=types.d.ts.map
+/**
+ * Block scope: `"shared"`, or exact test id and/or context (at least one;
+ * `{}` is not a scope). Readonly: validated scopes are frozen.
+ */
+type McpFakeScope = "shared" | Readonly<{
+  testId: string;
+  context?: string;
+}> | Readonly<{
+  testId?: string;
+  context: string;
+}>;
+/**
+ * `T` with every nested property and array read-only: the type of a value the
+ * MCP fakes store deep-freezes before it hands it out.
+ */
+type McpFakeDeepReadonly<T> = T extends ((...args: never[]) => unknown) ? T : T extends object ? { readonly [K in keyof T]: McpFakeDeepReadonly<T[K]> } : T;
+/** MCP `Annotations` on a content block. */
+interface McpFakeAnnotations {
+  audience?: Array<"user" | "assistant">;
+  /** From 0 (least) to 1 (most important). */
+  priority?: number;
+  /** RFC 3339 date-time with seconds and a `Z` or `±hh:mm` offset. */
+  lastModified?: string;
+}
+/** MCP `Icon` on a `resource_link` content block. */
+interface McpFakeIcon {
+  src: string;
+  mimeType?: string;
+  sizes?: string[];
+  theme?: "light" | "dark";
+}
+/** MCP `TextResourceContents` / `BlobResourceContents`: exactly one of `text` / `blob`. */
+type McpFakeResourceContents = {
+  uri: string;
+  mimeType?: string;
+  _meta?: Record<string, unknown>;
+} & ({
+  text: string;
+  blob?: never;
+} | {
+  blob: string;
+  text?: never;
+});
+type McpFakeContentCommon = {
+  annotations?: McpFakeAnnotations;
+  _meta?: Record<string, unknown>;
+};
+/** One MCP content block of a tool result (`ContentBlock`); `data` and `blob` are base64. */
+type McpFakeContentBlock = McpFakeContentCommon & ({
+  type: "text";
+  text: string;
+} | {
+  type: "image";
+  data: string;
+  mimeType: string;
+} | {
+  type: "audio";
+  data: string;
+  mimeType: string;
+} | {
+  type: "resource_link";
+  uri: string;
+  name: string;
+  title?: string;
+  description?: string;
+  mimeType?: string;
+  size?: number;
+  icons?: McpFakeIcon[];
+} | {
+  type: "resource";
+  resource: McpFakeResourceContents;
+});
+/** A full MCP `CallToolResult`, served unchanged. No other keys. */
+interface McpFakeFullResult {
+  content: McpFakeContentBlock[];
+  isError?: boolean;
+  structuredContent?: Record<string, unknown>;
+  _meta?: Record<string, unknown>;
+}
+/**
+ * Structured data: any JSON object without the `CallToolResult`
+ * keys, served as text plus `structuredContent`.
+ */
+type McpFakeStructuredResult = Record<string, unknown> & {
+  content?: never;
+  isError?: never;
+  structuredContent?: never;
+  _meta?: never;
+};
+/**
+ * A call entry's `result` value. Validation also checks what the type cannot
+ * say: base64 `data` / `blob`, `priority` from 0 to 1, the `lastModified`
+ * format, and plain JSON throughout. Unknown keys inside a content item are
+ * allowed and served as given.
+ */
+type McpFakeResult = string | McpFakeContentBlock[] | McpFakeFullResult | McpFakeStructuredResult;
+/** How a call entry matches: exactly one of `args` / `anyArgs`. */
+type McpFakeCallMatch = {
+  args: Record<string, unknown>;
+  anyArgs?: never;
+} | {
+  anyArgs: true;
+  args?: never;
+};
+/** What a call entry answers: exactly one of `result` / `error`. */
+type McpFakeCallAnswer = {
+  result: McpFakeResult;
+  error?: never;
+} | {
+  error: string;
+  result?: never;
+};
+/** One ordered answer for a tool. */
+type McpFakeCall = McpFakeCallMatch & McpFakeCallAnswer & {
+  id?: string;
+};
+/** One faked tool in a block. */
+interface McpFakeTool {
+  name: string;
+  description?: string;
+  inputSchema?: Record<string, unknown>;
+  calls: McpFakeCall[];
+}
+/** One `mcpFakes` block. */
+interface McpFakeBlock {
+  scope: McpFakeScope;
+  mount?: string;
+  undeclaredTools?: McpFakeUndeclaredPolicy;
+  tools: McpFakeTool[];
+}
+type McpFakeUndeclaredPolicy = "allow" | "deny";
+/**
+ * The resolved identity of one MCP request: test id, context and undeclared
+ * override, each from the request or else from the session.
+ * `null` means "not supplied". The identity shape the fake store's matching
+ * methods take (`applicable`, `selectTier`, `claim`, `policy`, `declaredTools`,
+ * `listTools`).
+ */
+interface McpFakeIdentity {
+  testId: string | null;
+  context: string | null;
+  undeclared: McpFakeUndeclaredPolicy | null;
+}
+/**
+ * One raw block as a loader hands it off, before validation. `source` is the
+ * entry-id source string; `blockIndex` is `null` when `mcpFakes` is a single object.
+ */
+interface McpFakeSource {
+  source: string;
+  blockIndex: number | null;
+  raw: unknown;
+}
+/**
+ * `response.mcpFake.outcome` on a `tools/call` journal entry. `evicted`:
+ * the request's test id lost its consumption state to the FIFO test-id cap.
+ */
+type McpFakeOutcome = "answered" | "mismatch" | "exhausted" | "not_declared" | "evicted";
+/**
+ * JSON-RPC error codes of the four fake failures, keyed by
+ * `error.data.aimock.code`. `-31010` and `-31011` sit outside the JSON-RPC
+ * reserved range. `MCP_FAKE_EVICTED` is for a lookup of a declared tool by a
+ * test id whose state the FIFO test-id cap evicted, until it is reset.
+ */
+declare const MCP_FAKE_ERROR_CODES: {
+  readonly MCP_FAKE_NOT_DECLARED: -32602;
+  readonly MCP_FAKE_MISMATCH: -32602;
+  readonly MCP_FAKE_EXHAUSTED: -31010;
+  readonly MCP_FAKE_EVICTED: -31011;
+};
+type McpFakeErrorCode = keyof typeof MCP_FAKE_ERROR_CODES;
 //#endregion
-export { ApiKeyAuthConfig, AudioResponse, ChaosAction, ChaosConfig, ChaosDefaults, ChatCompletion, ChatCompletionChoice, ChatCompletionMessage, ChatCompletionRequest, ChatMessage, ContentPart, ContentWithToolCallsResponse, EmbeddingFixtureOpts, EmbeddingResponse, ErrorResponse, FalQueueOpts, Fixture, FixtureBlock, FixtureFile, FixtureFileBlock, FixtureFileContentWithToolCallsResponse, FixtureFileEntry, FixtureFileResponse, FixtureFileTextResponse, FixtureFileToolCall, FixtureFileToolCallResponse, FixtureMatch, FixtureOpts, FixtureResponse, HandlerDefaults, ImageItem, ImageResponse, JournalEntry, MockServerOptions, Mountable, RawJSONResponse, RecordConfig, RecordProviderKey, RecordedTimings, ResponseFactory, ResponseOverrides, SSEChoice, SSEChunk, SSEDelta, SSEToolCallDelta, StreamingProfile, TextResponse, ToolCall, ToolCallMessage, ToolCallResponse, ToolDefinition, TranscriptionResponse, VideoResponse };
+export { ApiKeyAuthConfig, AudioResponse, ChaosAction, ChaosConfig, ChaosDefaults, ChatCompletion, ChatCompletionChoice, ChatCompletionMessage, ChatCompletionRequest, ChatMessage, ContentPart, ContentWithToolCallsResponse, EmbeddingFixtureOpts, EmbeddingResponse, ErrorResponse, FalQueueOpts, Fixture, FixtureBlock, FixtureFile, FixtureFileBlock, FixtureFileContentWithToolCallsResponse, FixtureFileEntry, FixtureFileResponse, FixtureFileTextResponse, FixtureFileToolCall, FixtureFileToolCallResponse, FixtureMatch, FixtureOpts, FixtureResponse, HandlerDefaults, ImageItem, ImageResponse, JournalBody, JournalEntry, MCP_FAKE_ERROR_CODES, McpFakeAnnotations, McpFakeBlock, McpFakeCall, McpFakeCallAnswer, McpFakeCallMatch, McpFakeContentBlock, McpFakeDeepReadonly, McpFakeErrorCode, McpFakeFullResult, McpFakeIcon, McpFakeIdentity, McpFakeOutcome, McpFakeResourceContents, McpFakeResult, McpFakeScope, McpFakeSource, McpFakeStructuredResult, McpFakeTool, McpFakeUndeclaredPolicy, MockServerOptions, Mountable, RawJSONResponse, RecordConfig, RecordProviderKey, RecordedTimings, ResponseFactory, ResponseOverrides, SSEChoice, SSEChunk, SSEDelta, SSEToolCallDelta, StreamingProfile, TextResponse, ToolCall, ToolCallMessage, ToolCallResponse, ToolDefinition, TranscriptionResponse, VideoResponse, VoiceDesignPreview, VoiceDesignResponse };
 //# sourceMappingURL=types.d.cts.map

package/dist/types.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.cts","names":[],"sources":["../src/types.ts"],"sourcesContent":[],"mappings":"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"}
+{"version":3,"file":"types.d.cts","names":[],"sources":["../src/types.ts"],"sourcesContent":[],"mappings":"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"}