@copilotkit/aimock 1.42.0 → 1.43.0

package/.claude-plugin/marketplace.json

@@ -9,7 +9,7 @@
       "source": {
         "source": "npm",
         "package": "@copilotkit/aimock",
-        "version": "^1.42.0"
+        "version": "^1.43.0"
       },
       "description": "Fixture authoring skill for @copilotkit/aimock — LLM, multimedia (image/TTS/transcription/video), MCP, A2A, AG-UI, vector, embeddings, structured output, sequential responses, streaming physics, record/replay, agent loop patterns, and debugging"
     }

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "aimock",
-  "version": "1.42.0",
+  "version": "1.43.0",
   "description": "Fixture authoring guidance for @copilotkit/aimock — LLM, multimedia, MCP, A2A, AG-UI, vector, and service mocking",
   "author": {
     "name": "CopilotKit"

package/CHANGELOG.md

@@ -1,5 +1,61 @@
 # @copilotkit/aimock
 
+## [1.43.0] - 2026-09-22
+
+> **BREAKING** — `aimock -h` is `--help`, not `--host`: `aimock -h 0.0.0.0` exits 1 with `Error: Unexpected argument '0.0.0.0'. This command does not take positional arguments`. Migration: `--host <string>` (long form only). The `llmock` bin (the Docker ENTRYPOINT) keeps `-h, --host` (#453).
+
+### Added
+
+- OpenAI GPT-Live mock, record and offline replay on `GET /v1/live/sessions`, with `onLive` fixtures (#468)
+- Live sessions enforce message/audio/queue/lifetime limits; recordings sanitize credentials (#468)
+- Live drift canaries for lifecycle, audio/transcript, delegation and usage, attributed to `openai-live` (#468)
+- Chaos `rateLimitRate` / `--chaos-ratelimit`: deterministic 429 with `Retry-After` (#449)
+- Chaos `latencyMs` / `--chaos-latency` now actually delays responses on every path (#449)
+- OpenAI Files API mock — byte-exact uploads, create-purpose enum, CORS on faults (#445)
+- OpenAI fine-tuning jobs mock — deterministic lifecycle, events, cursor pages (#447)
+- OpenAI Batches API mock — create/list/retrieve/cancel with real output files (#446)
+- `X-Request-Id` echoed or minted on every response; `?requestId=` filters the journal (#450)
+- `aimock validate` lints fixture files or directories offline, failing on broken files (#453)
+- ElevenLabs Voice Design record/replay — design, save-as-voice, and voice slot management (#452)
+- ElevenLabs Voice Design provenance block and strict-mode 503 coverage (#454)
+
+### Changed
+
+- **BREAKING:** `aimock -h` is `--help`, matching `aimock convert -h` and `aimock validate -h`; the host override is `--host` only. The `llmock` bin (the Docker entrypoint) keeps its own `-h, --host` — see the note above (#453)
+- `aimock --config ""`, `--port ""` and `--host ""` are usage errors naming the option (#453)
+- Realtime `OpenAI-Beta: realtime=v1` now returns the real sunset rejection, not a session (#461)
+- `POST /v1/images/variations` now replays the real removal 404; OpenAI deleted it (#462)
+- `ChaosAction` gains `"rateLimit"` — an exhaustive switch over it needs a case (#449)
+- `applyChaosAsync()` returns `false | "handled" | "unwritable"` instead of a bare `boolean` (#449)
+- Journal `headers` now ALWAYS carry `x-request-id` — exact `toEqual` asserts break (#450)
+
+### Deprecated
+
+- Synchronous `applyChaos()` warns once per process; it skips chaos latency. Use `await applyChaosAsync(...)` (#449)
+
+### Fixed
+
+- Reasoning-first chat streams with content and tool calls carry the assistant role in the first chunk (#470)
+- Journals and metrics reflect delivered vs interrupted responses; one-shot errors never double-deliver (#466)
+- Nonstreaming OpenAI chat returns block text and tools; text-only blocks finish normally on every provider (#467)
+- AG-UI drift reads generated 1.0 schemas; `AGUIRunStartedEvent` gains optional `protocolVersion` (#469)
+- Drift reports list `unverifiedSurfaces`; offline Bedrock/Vertex checks no longer skip silently (#460)
+- Drift docs match actual coverage; ElevenLabs drift separates vendor observations from fixture checks (#465)
+- Chaos no longer treats committed headers as a dead response; only status-writing actions are skipped (#449)
+- Chaos skip logs name what happened; `aimock_chaos_triggered_total` counts only written responses (#449)
+- A request whose chaos latency was cancelled by client hang-up is no longer served or journalled (#449)
+- Moderations echoes the request's `model`; default is now `omni-moderation-latest` (#459)
+- Image endpoints default to `gpt-image-1` — `dall-e-2`/`dall-e-3` were removed (#459)
+- AG-UI record/proxy forwards the caller's headers and raw body upstream; `Accept` is forced to SSE (#455)
+- The AG-UI recorder refuses to write a fixture from a non-stream or empty 2xx upstream reply (#455)
+- A MINTED `x-request-id` is no longer forwarded upstream in record/proxy mode (#450)
+
+## [1.42.1] - 2026-09-18
+
+### Fixed
+
+- Identify reasoning-first tool streams as assistant messages for MCP Apps (#470).
+
 ## [1.42.0] - 2026-09-13
 
 ### Added

package/README.md

@@ -55,14 +55,14 @@ await mock.stop();
 
 aimock mocks everything your AI app talks to:
 
-| Tool           | What it mocks                                                                                                                                                                                                    | Docs                                                |
-| -------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------- |
-| **LLMock**     | OpenAI (Chat/Responses/Realtime GA+Beta), Claude, Gemini (REST/Live/Interactions/Embeddings), Bedrock, Azure, Vertex AI, Ollama (chat/embeddings), Cohere (chat/embed), OpenRouter (chat/router), ElevenLabs TTS | [Providers](https://aimock.copilotkit.dev/docs)     |
-| **MCPMock**    | MCP tools, resources, prompts with session management                                                                                                                                                            | [MCP](https://aimock.copilotkit.dev/mcp-mock)       |
-| **A2AMock**    | Agent-to-agent protocol with SSE streaming                                                                                                                                                                       | [A2A](https://aimock.copilotkit.dev/a2a-mock)       |
-| **AGUIMock**   | AG-UI agent-to-UI event streams for frontend testing                                                                                                                                                             | [AG-UI](https://aimock.copilotkit.dev/agui-mock)    |
-| **VectorMock** | Pinecone, Qdrant, ChromaDB compatible endpoints                                                                                                                                                                  | [Vector](https://aimock.copilotkit.dev/vector-mock) |
-| **Services**   | Tavily search, Cohere rerank, OpenAI moderation, ElevenLabs TTS                                                                                                                                                  | [Services](https://aimock.copilotkit.dev/services)  |
+| Tool           | What it mocks                                                                                                                                                                                                                                                                                                  | Docs                                                |
+| -------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------- |
+| **LLMock**     | OpenAI (Chat/Responses/Realtime GA/GPT-Live), Claude, Gemini (REST/Live/Interactions/Embeddings), Bedrock, Azure, Vertex AI, Ollama (chat/embeddings), Cohere (chat/embed), OpenRouter (chat/router/video), BytePlus Ark (chat/images/video), Grok (video), Veo (video), fal.ai, ElevenLabs (TTS/Voice Design) | [Providers](https://aimock.copilotkit.dev/docs)     |
+| **MCPMock**    | MCP tools, resources, prompts with session management                                                                                                                                                                                                                                                          | [MCP](https://aimock.copilotkit.dev/mcp-mock)       |
+| **A2AMock**    | Agent-to-agent protocol with SSE streaming                                                                                                                                                                                                                                                                     | [A2A](https://aimock.copilotkit.dev/a2a-mock)       |
+| **AGUIMock**   | AG-UI agent-to-UI event streams for frontend testing                                                                                                                                                                                                                                                           | [AG-UI](https://aimock.copilotkit.dev/agui-mock)    |
+| **VectorMock** | Pinecone, Qdrant, ChromaDB compatible endpoints                                                                                                                                                                                                                                                                | [Vector](https://aimock.copilotkit.dev/vector-mock) |
+| **Services**   | Tavily search, Cohere rerank, OpenAI moderation                                                                                                                                                                                                                                                                | [Services](https://aimock.copilotkit.dev/services)  |
 
 Run them all on one port with `npx @copilotkit/aimock --config aimock.json`, or use the programmatic API to compose exactly what you need.
 
@@ -72,16 +72,19 @@ Run them all on one port with `npx @copilotkit/aimock --config aimock.json`, or
 - **Timing-aware recording and replay** — Recorded fixtures capture per-frame arrival timestamps; replay uses recorded timings for approximate timing reproduction based on recorded TTFT and inter-frame cadence (replay chunk count may differ from recording — TTFT and average pace are preserved, not per-token fidelity) with configurable `--replay-speed` multiplier
 - **[Recorded token usage and cost](https://aimock.copilotkit.dev/record-replay)** — Recording captures the final usage frame of a streaming completion, so replayed fixtures serve real `prompt_tokens` / `completion_tokens` instead of a length estimate; OpenRouter's provider-reported `usage.cost` and its `cost_details` / `*_tokens_details` breakdowns are captured too, so an app that bills from real provider cost can e2e-test its wallet path from a tape
 - **[Multi-turn Conversations](https://aimock.copilotkit.dev/multi-turn)** — Record and replay multi-turn traces with tool rounds; match distinct turns via `turnIndex`, `hasToolResult`, `toolCallId`, `toolResultContains` (gate on the tool-result payload), `sequenceIndex`, `systemMessage` (gate on host-supplied agent context), or custom predicates
-- **[14 providers across 16 API surfaces](https://aimock.copilotkit.dev/docs)** — OpenAI Chat, OpenAI Responses, OpenAI Realtime (GA + Beta shim), Claude, Gemini REST, Gemini embedContent, Gemini Live, Gemini Interactions, Azure, Bedrock, Vertex AI, Ollama (chat + embeddings), Cohere (chat + embed), OpenRouter (chat + router failover), BytePlus Ark (OpenAI-compatible chat + images under `/api/v3`), ElevenLabs TTS — full streaming support
-- **Multimedia APIs** — [image generation](https://aimock.copilotkit.dev/images) (DALL-E, Imagen), [image editing](https://aimock.copilotkit.dev/images) (/v1/images/edits), [text-to-speech](https://aimock.copilotkit.dev/speech) (OpenAI + ElevenLabs), [audio transcription](https://aimock.copilotkit.dev/transcription), [audio translation](https://aimock.copilotkit.dev/transcription) (/v1/audio/translations), [video generation](https://aimock.copilotkit.dev/video), [OpenRouter video generation](https://aimock.copilotkit.dev/openrouter-video) (/api/v1/videos with async job lifecycle), [Google Veo video generation](https://aimock.copilotkit.dev/veo-video) (:predictLongRunning + /v1beta/operations async lifecycle), [Grok Imagine video generation](https://aimock.copilotkit.dev/grok-video) (/v1/videos/generations with async job lifecycle), [BytePlus Ark video generation](https://aimock.copilotkit.dev/byteplus-video) (Seedance, /api/v3/contents/generations/tasks with async task lifecycle), [fal.ai](https://aimock.copilotkit.dev/fal-ai) (image / video / audio with queue lifecycle)
+- **[11 providers across 22 API surfaces](https://aimock.copilotkit.dev/docs)** — OpenAI Chat, OpenAI Responses, OpenAI Realtime (GA; an `OpenAI-Beta: realtime=v1` request gets the real sunset rejection), GPT-Live, Claude, Gemini REST, Gemini embedContent, Gemini Live, Gemini Interactions, Azure, Bedrock, Vertex AI, Ollama (chat + embeddings), Cohere (chat + embed), OpenRouter (chat + router failover), BytePlus Ark (OpenAI-compatible chat + images under `/api/v3`), ElevenLabs TTS and Voice Design — full streaming support
+- **Multimedia APIs** — [image generation](https://aimock.copilotkit.dev/images) (`gpt-image-1` default, Imagen; `/v1/images/variations` replays OpenAI's removal 404), [image editing](https://aimock.copilotkit.dev/images) (/v1/images/edits), [text-to-speech](https://aimock.copilotkit.dev/speech) (OpenAI + ElevenLabs TTS and Voice Design), [audio transcription](https://aimock.copilotkit.dev/transcription), [audio translation](https://aimock.copilotkit.dev/transcription) (/v1/audio/translations), [video generation](https://aimock.copilotkit.dev/video), [OpenRouter video generation](https://aimock.copilotkit.dev/openrouter-video) (/api/v1/videos with async job lifecycle), [Google Veo video generation](https://aimock.copilotkit.dev/veo-video) (:predictLongRunning + /v1beta/operations async lifecycle), [Grok Imagine video generation](https://aimock.copilotkit.dev/grok-video) (/v1/videos/generations with async job lifecycle), [BytePlus Ark video generation](https://aimock.copilotkit.dev/byteplus-video) (Seedance, /api/v3/contents/generations/tasks with async task lifecycle), [fal.ai](https://aimock.copilotkit.dev/fal-ai) (image / video / audio with queue lifecycle)
+- **OpenAI platform APIs** — [Files](https://aimock.copilotkit.dev/files) (byte-exact uploads, purpose validation), [fine-tuning jobs](https://aimock.copilotkit.dev/fine-tuning) (deterministic lifecycle, events, cursor pages) and Batches (`/v1/batches` create/list/retrieve/cancel with deterministic poll progression and real output files)
 - **[MCP](https://aimock.copilotkit.dev/mcp-mock) / [A2A](https://aimock.copilotkit.dev/a2a-mock) / [AG-UI](https://aimock.copilotkit.dev/agui-mock) / [Vector](https://aimock.copilotkit.dev/vector-mock)** — Mock every protocol your AI agents use
-- **[Chaos Testing](https://aimock.copilotkit.dev/chaos-testing)** — 500 errors, malformed JSON, mid-stream disconnects at any probability; read, set and clear the rates at runtime via `GET` / `POST` / `DELETE /__aimock/chaos`, scoped to the caller's `X-Test-Id` so one test cannot destabilise the suite running beside it
-- **Request journal** — `GET /__aimock/journal` returns every recorded request, filterable by `path`, `method`, `status`, `service` and `testId` with `limit` / `offset` paging and an `X-Total-Count` header carrying the pre-pagination total
+- **[Chaos Testing](https://aimock.copilotkit.dev/chaos-testing)** — 500 errors, malformed JSON, mid-stream disconnects and 429 rate limits (`--chaos-ratelimit`, with `Retry-After`) at any probability, plus a fixed pre-handling delay (`--chaos-latency <ms>`); read, set and clear the rates at runtime via `GET` / `POST` / `DELETE /__aimock/chaos`, scoped to the caller's `X-Test-Id` so one test cannot destabilise the suite running beside it
+- **Request journal** — `GET /__aimock/journal` returns every recorded request, filterable by `path`, `method`, `status`, `service`, `testId` and `requestId` with `limit` / `offset` paging and an `X-Total-Count` header carrying the pre-pagination total
+- **Request IDs** — every response carries `X-Request-Id`, echoing the caller's header or minting one; the journal stores it on each entry and `GET /__aimock/journal?requestId=<id>` returns that request. A minted id is never forwarded upstream in record/proxy mode
 - **Per-Request Strict Mode** — `X-AIMock-Strict` header overrides the server-level `--strict` flag per request (`true`/`1` = strict, `false`/`0` = lenient)
 - **Context-Based Fixture Routing** — `X-AIMock-Context` header scopes fixtures per integration; fixtures with `match.context` only match requests carrying that context, fixtures without it remain shared
 - **[Drift Detection](https://aimock.copilotkit.dev/drift-detection)** — Daily CI validation against real APIs
 - **[Streaming Physics](https://aimock.copilotkit.dev/streaming-physics)** — Configurable `ttft`, `tps`, and `jitter`
 - **[WebSocket APIs](https://aimock.copilotkit.dev/websocket)** — OpenAI Realtime (GA protocol with models: gpt-realtime, gpt-realtime-2, gpt-realtime-1.5, gpt-realtime-mini; transcription/translation via gpt-4o-transcribe, gpt-4o-mini-transcribe, whisper-1; image input; commentary phase), Responses WS, Gemini Live
+- **[GPT-Live](https://aimock.copilotkit.dev/websocket#openai-live)** — Mock, record, and replay primary WebSocket sessions at `/v1/live/sessions` in client and managed modes, with fixture-backed audio and backend tool continuation. Saved fixtures replay offline; aimock does not synthesize speech. This voice surface is separate from OpenAI text-model family support; WebRTC/SDP and sideband connections are outside this scope.
 - **[Prometheus Metrics](https://aimock.copilotkit.dev/metrics)** — Request counts, latencies, fixture match rates
 - **[Docker + Helm](https://aimock.copilotkit.dev/docker)** — Container image and Helm chart for CI/CD
 - **[Vitest & Jest Plugins](https://aimock.copilotkit.dev/test-plugins)** — Zero-config `useAimock()` with auto lifecycle and env patching
@@ -130,14 +133,91 @@ npx -p @copilotkit/aimock llmock --record --provider-openai https://api.openai.c
 npx -p @copilotkit/aimock llmock -p 4010 -f ./fixtures --replay-speed 2
 
 # Convert fixtures from other tools
-npx @copilotkit/aimock convert vidaimock ./templates/ ./fixtures/
-npx @copilotkit/aimock convert mockllm ./config.yaml ./fixtures/
+npx @copilotkit/aimock convert vidaimock ./templates/ ./fixtures/vidaimock.json
+npx @copilotkit/aimock convert mockllm ./config.yaml ./fixtures/mockllm.json
+
+# Validate fixtures offline (file or directory, recursive)
+npx @copilotkit/aimock validate ./fixtures/
+# --strict on the whole shipped tree exits 1 (adk/mastra repeat a userMessage across files)
+npx @copilotkit/aimock validate --strict --json ./fixtures/examples/llm/blocks-tool-first.json
 
 # Docker
 docker run -d -p 4010:4010 -v "$(pwd)/fixtures:/fixtures" ghcr.io/copilotkit/aimock -f /fixtures -h 0.0.0.0
 ```
 
-> **Note on `llmock` vs `aimock` CLIs.** The `llmock` bin is retained as a compat alias for users of the pre-1.7.0 `@copilotkit/llmock` package. It runs a narrower flag-driven CLI without `--config` or the `convert` subcommand. New projects should use `aimock` (or `npx @copilotkit/aimock`) for full feature support.
+> **Note on `llmock` vs `aimock` CLIs.** The `llmock` bin is retained as a compat alias for users of the pre-1.7.0 `@copilotkit/llmock` package. It runs a narrower flag-driven CLI without `--config` or the `convert` and `validate` subcommands. New projects should use `aimock` (or `npx @copilotkit/aimock`) for full feature support.
+
+### Offline fixture validation
+
+`aimock validate [--strict] [--json] [--] <path> [more paths ...]` lints fixtures without starting a server. Each path is a fixture file or a directory of them (walked recursively for `*.json`, like `--fixtures <dir>`). `--strict` treats warnings as errors; `--json` emits a machine-readable report for CI; `--` stops option parsing so a path beginning with `-` is still reachable. A path given twice is validated twice, because the server loads one set of fixtures per `--fixtures` it is given; the duplicate fixtures that produces are reported as the server reports them, one finding per fixture and rule. Such a path is printed as `<path>[<n>]`, numbering its mentions from 1, so each load — and every cross-file reference to its fixtures — names one of them. `--json` carries that number as `mention` on every file, whether or not the path repeats.
+
+Files are checked one at a time and then again as one combined set in load order, so the rules that span files — a `userMessage` duplicated across two files, an empty catch-all `match` that is last in its own file but not last overall — fire here as they do on the server. Cross-file findings are prefixed `cross-file:`, attributed to the file owning the fixture, and name the other file. One the per-file pass already made against the same fixture never prints a second line: naming the same fixtures it is dropped, and naming others — a shadow that reaches into another load — it replaces the per-file wording in place, at the same position.
+
+Against the server's `--validate-on-load` it is stricter in one direction and weaker in another. **Stricter:** there an unreadable, unparseable, or wrong-shape file only warns on stderr and contributes zero fixtures, and startup continues as long as the run loaded at least one fixture from somewhere, whereas `validate` fails the run on every such file. The one exception, which matches the loader: a `*.json` file found by **walking** a directory and having no top-level `"fixtures"` key at all is not a fixture file (an aimock config, say), so it is passed over with a `skipped (...)` line instead of failing the run — a file you name on the command line is still validated, and still fails on the wrong shape. Two walk hazards the server does not survive are refused outright rather than mirrored: a `*.json` path that is not a regular file (a FIFO, a socket, a device) is a per-file error here, where the server's `readFileSync` blocks on it forever; and a directory symlink pointing back at a directory already being walked is reported once as a cycle, where the server recurses through it until the kernel returns `ELOOP` and loads those levels' fixtures over and over. **Equal:** the fixture rules themselves, and the zero-fixture rule — a run whose inputs yield no fixtures at all is an error, matching the server's startup abort, while a single `{"fixtures": []}` file alongside files that do load fixtures is fine in both. Equal too in what the inputs expand to: a path named twice, and a directory reached both directly and through an acyclic symlink to it, are validated once per mention, exactly as the server loads one `--fixtures` source per mention, and each fixture-and-rule pair is reported once — the count the server logs. **Weaker:** it is a static lint that starts no server and reads local paths only, so it says nothing about binding, remote `--fixtures <url>` sources, `--watch` reloads, or any runtime behaviour. An `http://` or `https://` path is refused by name — `Remote fixture source: this lint reads local paths only (the server's --fixtures accepts a URL; validate does not) — download the file and validate the local copy` — rather than reported as a missing file. "The server" there is the `llmock` bin (`dist/cli.js`, the Docker entrypoint), whose `-f, --fixtures` takes a filesystem path or an `https://`/`http://` URL to a `.json` fixture file; the `aimock` bin has no `--fixtures` flag, and the `llm.fixtures` in its `--config` file is resolved as a filesystem path only.
+
+Anything the filesystem or a fixture entry can throw is contained in the report instead of crashing the run: a malformed entry, an unreadable file or directory, a stat failure, or a symlink cycle each becomes a per-file `[error]` line and exits 1. One stat failure is deliberately silent: a directory entry that vanishes between the `readdir` and the `stat` (`ENOENT` — a dangling symlink, or a file deleted mid-walk) is skipped without a finding, exactly as the server's loader skips it; every other stat failure is surfaced. A directory argument that walks cleanly but holds no `*.json` files is likewise a per-path `[error]` and exits 1. A crash inside the validator itself is contained too: a per-file one becomes a file-level `[error]` naming no entry, and one in the combined pass becomes a run-level `[error]` printed after the per-file output.
+
+Errors go to stderr while `OK` and summary lines go to stdout; warnings follow the exit they produce — stdout by default, stderr under `--strict`. Every file gets exactly one stdout line — including a file that failed fatally, and a file the walk skipped (`<file>: skipped (...)`) — so a reader tallying stdout never loses a file. `OK` is withheld in one case: on a run that failed because it loaded no fixtures at all, the file that loaded none reads `<file>: 0 fixture(s), loaded nothing — see the run-level error`. With `--json`, stdout carries the report alone and the one-line failure reason goes to stderr; a usage error is reported the same way, as a document with `files: []` and the reason in `run.errors`. Exit codes: `0` clean; `1` everything else — validation errors, a malformed fixture entry, unreadable/unparseable files, a NAMED path of the wrong shape (a walked one is skipped instead), a remote `http(s)://` path, a stat failure or symlink cycle while walking a directory, a `*.json` path that is not a regular file, a directory holding no `*.json` files, no fixtures loaded at all, `--strict` warnings, or a usage error (no paths given, or an unknown option). There is no exit code 2; every other CLI in this package reports a usage error as 1 too.
+
+`--json` emits one document on stdout, and only that document — a usage error included. Validating a directory holding a file with invalid JSON and a file with one bad entry and a duplicate `userMessage`:
+
+```json
+{
+  "strict": false,
+  "failed": true,
+  "files": [
+    {
+      "file": "fixtures/badjson.json",
+      "mention": 1,
+      "fixtures": 0,
+      "errors": [
+        {
+          "message": "Invalid JSON: Expected property name or '}' in JSON at position 1 (line 1 column 2)"
+        }
+      ],
+      "warnings": [],
+      "fatal": "Invalid JSON: Expected property name or '}' in JSON at position 1 (line 1 column 2)"
+    },
+    {
+      "file": "fixtures/mixed.json",
+      "mention": 1,
+      "fixtures": 2,
+      "errors": [
+        {
+          "index": 0,
+          "message": "Invalid fixture entry #0: missing or non-object \"match\" and \"response\" — every entry needs { \"match\": { ... }, \"response\": { ... } }"
+        }
+      ],
+      "warnings": [
+        {
+          "index": 2,
+          "message": "duplicate userMessage 'hi' — shadows fixture 1"
+        }
+      ]
+    }
+  ],
+  "run": {
+    "fixtures": 2,
+    "errors": []
+  }
+}
+```
+
+A usage error carries the reason in `run.errors` (`aimock validate --json`, exit 1):
+
+```json
+{
+  "strict": false,
+  "failed": true,
+  "files": [],
+  "run": {
+    "fixtures": 0,
+    "errors": ["no fixture paths given."]
+  }
+}
+```
+
+`failed` is the boolean the exit code follows, and `strict` echoes the flag it was computed under. `files` has one entry per path the run touched, in argv/walk order: `mention` is which load of that path this is (1-based, always present); `fixtures` is how many entries converted; `skipped` (present only when set) is why a walked non-fixture file was passed over; `fatal` (present only when set) is the reason the file produced no report at all, and that same reason also appears in `errors`, so a tally of `files[].errors` matches the error count on the file's stdout line; and `errors`/`warnings` hold findings. A finding always has `message`; `index` is the entry it belongs to and is **absent** on a file-level finding; `detail` carries the raw thrown text when `message` is a rephrasing of it. `run` covers the combined pass: `fixtures` is the total fixture count across every file, and `errors` holds run-level strings such as `"Cross-file validation failed: ..."`, the `"No fixtures loaded from any input — the server aborts startup on this under --validate-on-load/--strict"` line, or the reason a usage error failed.
 
 ### Remote fixture URLs
 
@@ -147,7 +227,7 @@ Private and link-local addresses (loopback, RFC1918, CGNAT, cloud metadata, ULA,
 
 ### Replay matching & `AIMOCK_STRICT_TURN_INDEX`
 
-On replay, `turnIndex` is a non-fatal disambiguator, not a hard reject gate: a content-matching fixture is served even when its scripted `turnIndex` differs from the request's assistant-message count. This kills false "no fixture matched" misses for multi-bubble agent runs (multi-step agents emit several assistant bubbles per logical turn). When a served fixture diverges from its scripted `turnIndex`, the match diagnostic carries `turnIndexRelaxed: true` and aimock logs a one-shot warning (at the `warn` log level — silent by default). To restore the legacy strict behavior where a defined `turnIndex` must equal the assistant count exactly, set `AIMOCK_STRICT_TURN_INDEX=1`. The record path is always strict regardless of this flag.
+On replay, `turnIndex` is a non-fatal disambiguator, not a hard reject gate: a content-matching fixture is served even when its scripted `turnIndex` differs from the request's assistant-message count. This kills false "no fixture matched" misses for multi-bubble agent runs (multi-step agents emit several assistant bubbles per logical turn). When a served fixture diverges from its scripted `turnIndex`, the match diagnostic carries `turnIndexRelaxed: true` and aimock logs a one-shot warning (at the `warn` log level, so it is silent under the programmatic default, which is `silent`, and printed by the `llmock` CLI, which defaults `--log-level` to `info`). To restore the legacy strict behavior where a defined `turnIndex` must equal the assistant count exactly, set `AIMOCK_STRICT_TURN_INDEX=1`. The record path is always strict regardless of this flag.
 
 ## API-key validation
 
@@ -188,6 +268,8 @@ In record or `--proxy-only` mode, aimock forwards the caller's auth header to th
 
 The Gemini interactions provider mode reuses `AIMOCK_PROVIDER_GEMINI_KEY` (same upstream API as Gemini). An empty-string value is treated as unset.
 
+> **Which binary reads them.** Only the `llmock` bin reads `AIMOCK_PROVIDER_*_KEY` from the environment (it fills `record.providerKeys` at startup). `aimock --config` does not read these variables: the config loader passes `llm.record` through verbatim, so under `aimock --config` set `llm.record.providerKeys` in the JSON instead. The programmatic API likewise takes `record.providerKeys` in `LLMock` options.
+
 This is opt-in and backward-compatible: with no key configured the feature is inert and the caller's header passes through as-is. Injection fires only when the caller sent no credential **or** a dummy credential prefixed with `sk-aimock-` (overridable via `AIMOCK_DUMMY_KEY_MARKER`); a real caller key never starting with that marker is always forwarded verbatim, so the caller overrides aimock. Signed and exchanged credentials — AWS Bedrock (SigV4) and Vertex AI (OAuth) — are never rewritten and always forwarded unchanged. (Azure's static `api-key` is injected; a real Microsoft Entra ID `Authorization: Bearer` token from the caller is never dummy-prefixed, so it too passes through verbatim.)
 
 ## Framework Guides
@@ -206,6 +288,10 @@ Step-by-step migration guides: [MSW](https://aimock.copilotkit.dev/migrate-from-
 
 [AG-UI](https://github.com/ag-ui-protocol/ag-ui) uses aimock for its [end-to-end test suite](https://github.com/ag-ui-protocol/ag-ui/tree/main/apps/dojo/e2e), verifying AI agent behavior across LLM providers with [fixture-driven responses](https://github.com/ag-ui-protocol/ag-ui/tree/main/apps/dojo/e2e/fixtures/openai).
 
+## Deprecated & removed APIs
+
+aimock keeps mocking provider surfaces that upstream has deprecated — that is when test scaffolding matters most, since your code still calls them while you migrate. It declines to mock the success path of APIs that have actually been removed: a mock that answers `200` where the real endpoint is gone manufactures a passing test for code that cannot work. Full policy: [Deprecated & Removed APIs](https://aimock.copilotkit.dev/deprecation-policy).
+
 ## License
 
 MIT

package/dist/agui-mock.cjs

@@ -129,7 +129,7 @@ var AGUIMock = class {
 			return true;
 		}
 		if (this.recordConfig) {
-			const result = await require_agui_recorder.proxyAndRecordAGUI(req, res, input, this.fixtures, this.recordConfig, this.logger);
+			const result = await require_agui_recorder.proxyAndRecordAGUI(req, res, input, this.fixtures, this.recordConfig, this.logger, body);
 			if (result !== false) {
 				this.journalRequest(req, pathname, result);
 				return true;

package/dist/agui-mock.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"agui-mock.cjs","names":["Logger","buildTextResponse","buildToolCallResponse","buildStateUpdate","buildReasoningResponse","readBody","findFixture","writeAGUIEventStream","proxyAndRecordAGUI","http","flattenHeaders"],"sources":["../src/agui-mock.ts"],"sourcesContent":["import * as http from \"node:http\";\nimport type { Mountable } from \"./types.js\";\nimport type { Journal } from \"./journal.js\";\nimport type { MetricsRegistry } from \"./metrics.js\";\nimport type {\n  AGUIFixture,\n  AGUIMockOptions,\n  AGUIRecordConfig,\n  AGUIEvent,\n  AGUIRunAgentInput,\n} from \"./agui-types.js\";\nimport {\n  findFixture,\n  buildTextResponse,\n  buildToolCallResponse,\n  buildStateUpdate,\n  buildReasoningResponse,\n  writeAGUIEventStream,\n} from \"./agui-handler.js\";\nimport { flattenHeaders, readBody } from \"./helpers.js\";\nimport { proxyAndRecordAGUI } from \"./agui-recorder.js\";\nimport { Logger, type LogLevel } from \"./logger.js\";\n\nexport class AGUIMock implements Mountable {\n  private fixtures: AGUIFixture[] = [];\n  private server: http.Server | null = null;\n  private journal: Journal | null = null;\n  private registry: MetricsRegistry | null = null;\n  private options: AGUIMockOptions;\n  private baseUrl = \"\";\n  private recordConfig: AGUIRecordConfig | undefined;\n  private logger: Logger;\n\n  constructor(options?: AGUIMockOptions) {\n    this.options = options ?? {};\n    this.logger = new Logger((options?.logLevel as LogLevel) ?? \"warn\");\n  }\n\n  // ---- Fluent registration API ----\n\n  addFixture(fixture: AGUIFixture): this {\n    this.fixtures.push(fixture);\n    return this;\n  }\n\n  onMessage(pattern: string | RegExp, text: string, opts?: { delayMs?: number }): this {\n    const events = buildTextResponse(text);\n    this.fixtures.push({\n      match: { message: pattern },\n      events,\n      delayMs: opts?.delayMs,\n    });\n    return this;\n  }\n\n  onRun(pattern: string | RegExp, events: AGUIEvent[], delayMs?: number): this {\n    this.fixtures.push({\n      match: { message: pattern },\n      events,\n      delayMs,\n    });\n    return this;\n  }\n\n  onToolCall(\n    pattern: string | RegExp,\n    toolName: string,\n    args: string,\n    opts?: { result?: string; delayMs?: number },\n  ): this {\n    const events = buildToolCallResponse(toolName, args, {\n      result: opts?.result,\n    });\n    this.fixtures.push({\n      match: { message: pattern },\n      events,\n      delayMs: opts?.delayMs,\n    });\n    return this;\n  }\n\n  onStateKey(key: string, snapshot: Record<string, unknown>, delayMs?: number): this {\n    const events = buildStateUpdate(snapshot);\n    this.fixtures.push({\n      match: { stateKey: key },\n      events,\n      delayMs,\n    });\n    return this;\n  }\n\n  onReasoning(pattern: string | RegExp, text: string, opts?: { delayMs?: number }): this {\n    const events = buildReasoningResponse(text);\n    this.fixtures.push({\n      match: { message: pattern },\n      events,\n      delayMs: opts?.delayMs,\n    });\n    return this;\n  }\n\n  onPredicate(\n    predicate: (input: AGUIRunAgentInput) => boolean,\n    events: AGUIEvent[],\n    delayMs?: number,\n  ): this {\n    this.fixtures.push({\n      match: { predicate },\n      events,\n      delayMs,\n    });\n    return this;\n  }\n\n  onToolResult(toolCallId: string, events: AGUIEvent[], delayMs?: number): this {\n    this.fixtures.push({\n      match: { toolCallId },\n      events,\n      delayMs,\n    });\n    return this;\n  }\n\n  enableRecording(config: AGUIRecordConfig): this {\n    this.recordConfig = config;\n    return this;\n  }\n\n  reset(): this {\n    this.fixtures = [];\n    this.recordConfig = undefined;\n    return this;\n  }\n\n  // ---- Mountable interface ----\n\n  async handleRequest(\n    req: http.IncomingMessage,\n    res: http.ServerResponse,\n    pathname: string,\n  ): Promise<boolean> {\n    if (req.method !== \"POST\" || (pathname !== \"/\" && pathname !== \"\")) {\n      return false;\n    }\n\n    if (this.registry) {\n      this.registry.incrementCounter(\"aimock_agui_requests_total\", { method: \"POST\" });\n    }\n\n    let body: string;\n    try {\n      body = await readBody(req);\n    } catch (err) {\n      res.writeHead(400, { \"Content-Type\": \"application/json\" });\n      const detail = err instanceof Error ? err.message : \"body read failed\";\n      res.end(JSON.stringify({ error: `Failed to read request body: ${detail}` }));\n      this.journalRequest(req, pathname, 400);\n      return true;\n    }\n\n    let input: AGUIRunAgentInput;\n    try {\n      input = JSON.parse(body) as AGUIRunAgentInput;\n    } catch (err) {\n      res.writeHead(400, { \"Content-Type\": \"application/json\" });\n      const detail = err instanceof Error ? err.message : \"unknown parse error\";\n      res.end(JSON.stringify({ error: `Invalid JSON body: ${detail}` }));\n      this.journalRequest(req, pathname, 400);\n      return true;\n    }\n\n    if (input.messages !== undefined && !Array.isArray(input.messages)) {\n      res.writeHead(400, { \"Content-Type\": \"application/json\" });\n      res.end(\n        JSON.stringify({\n          error: \"Invalid input: 'messages' must be an array when provided\",\n        }),\n      );\n      this.journalRequest(req, pathname, 400);\n      return true;\n    }\n\n    const fixture = findFixture(input, this.fixtures);\n\n    if (fixture) {\n      await writeAGUIEventStream(res, fixture.events, { delayMs: fixture.delayMs });\n      this.journalRequest(req, pathname, 200);\n      return true;\n    }\n\n    // No match — if recording is enabled, proxy to upstream\n    if (this.recordConfig) {\n      const result = await proxyAndRecordAGUI(\n        req,\n        res,\n        input,\n        this.fixtures,\n        this.recordConfig,\n        this.logger,\n      );\n      if (result !== false) {\n        this.journalRequest(req, pathname, result);\n        return true;\n      }\n    }\n\n    // No match, no recorder — 404\n    res.writeHead(404, { \"Content-Type\": \"application/json\" });\n    res.end(JSON.stringify({ error: \"No matching AG-UI fixture\" }));\n    this.journalRequest(req, pathname, 404);\n    return true;\n  }\n\n  health(): { status: string; fixtures: number } {\n    return {\n      status: \"ok\",\n      fixtures: this.fixtures.length,\n    };\n  }\n\n  setJournal(journal: Journal): void {\n    this.journal = journal;\n  }\n\n  setBaseUrl(url: string): void {\n    this.baseUrl = url;\n  }\n\n  setRegistry(registry: MetricsRegistry): void {\n    this.registry = registry;\n  }\n\n  // ---- Standalone mode ----\n\n  async start(): Promise<string> {\n    if (this.server) {\n      throw new Error(\"AGUIMock server already started\");\n    }\n\n    const host = this.options.host ?? \"127.0.0.1\";\n    const port = this.options.port ?? 0;\n\n    return new Promise<string>((resolve, reject) => {\n      const srv = http.createServer(async (req, res) => {\n        const url = new URL(req.url ?? \"/\", `http://${req.headers.host ?? \"localhost\"}`);\n        const handled = await this.handleRequest(req, res, url.pathname).catch((err) => {\n          this.logger.error(`AGUIMock request error: ${err instanceof Error ? err.message : err}`);\n          if (!res.headersSent) {\n            res.writeHead(500);\n            res.end(\"Internal server error\");\n          } else if (!res.writableEnded) {\n            res.end();\n          }\n          this.journalRequest(req, url.pathname, res.statusCode);\n          return true;\n        });\n        if (!handled && !res.headersSent) {\n          res.writeHead(404, { \"Content-Type\": \"application/json\" });\n          res.end(JSON.stringify({ error: \"Not found\" }));\n          this.journalRequest(req, url.pathname, 404);\n        }\n      });\n\n      srv.on(\"error\", reject);\n\n      srv.listen(port, host, () => {\n        const addr = srv.address();\n        if (typeof addr === \"object\" && addr !== null) {\n          this.baseUrl = `http://${host}:${addr.port}`;\n        }\n        this.server = srv;\n        resolve(this.baseUrl);\n      });\n    });\n  }\n\n  async stop(): Promise<void> {\n    if (!this.server) {\n      throw new Error(\"AGUIMock server not started\");\n    }\n    const srv = this.server;\n    await new Promise<void>((resolve, reject) => {\n      srv.close((err: Error | undefined) => (err ? reject(err) : resolve()));\n    });\n    this.server = null;\n  }\n\n  get url(): string {\n    if (!this.server) {\n      throw new Error(\"AGUIMock server not started\");\n    }\n    return this.baseUrl;\n  }\n\n  // ---- Private helpers ----\n\n  private journalRequest(req: http.IncomingMessage, pathname: string, status: number): void {\n    if (this.journal) {\n      this.journal.add({\n        method: req.method ?? \"POST\",\n        path: req.url ?? pathname,\n        headers: flattenHeaders(req.headers),\n        body: null,\n        service: \"agui\",\n        response: { status, fixture: null },\n      });\n    }\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"agui-mock.cjs","names":["Logger","buildTextResponse","buildToolCallResponse","buildStateUpdate","buildReasoningResponse","readBody","findFixture","writeAGUIEventStream","proxyAndRecordAGUI","http","flattenHeaders"],"sources":["../src/agui-mock.ts"],"sourcesContent":["import * as http from \"node:http\";\nimport type { Mountable } from \"./types.js\";\nimport type { Journal } from \"./journal.js\";\nimport type { MetricsRegistry } from \"./metrics.js\";\nimport type {\n  AGUIFixture,\n  AGUIMockOptions,\n  AGUIRecordConfig,\n  AGUIEvent,\n  AGUIRunAgentInput,\n} from \"./agui-types.js\";\nimport {\n  findFixture,\n  buildTextResponse,\n  buildToolCallResponse,\n  buildStateUpdate,\n  buildReasoningResponse,\n  writeAGUIEventStream,\n} from \"./agui-handler.js\";\nimport { flattenHeaders, readBody } from \"./helpers.js\";\nimport { proxyAndRecordAGUI } from \"./agui-recorder.js\";\nimport { Logger, type LogLevel } from \"./logger.js\";\n\nexport class AGUIMock implements Mountable {\n  private fixtures: AGUIFixture[] = [];\n  private server: http.Server | null = null;\n  private journal: Journal | null = null;\n  private registry: MetricsRegistry | null = null;\n  private options: AGUIMockOptions;\n  private baseUrl = \"\";\n  private recordConfig: AGUIRecordConfig | undefined;\n  private logger: Logger;\n\n  constructor(options?: AGUIMockOptions) {\n    this.options = options ?? {};\n    this.logger = new Logger((options?.logLevel as LogLevel) ?? \"warn\");\n  }\n\n  // ---- Fluent registration API ----\n\n  addFixture(fixture: AGUIFixture): this {\n    this.fixtures.push(fixture);\n    return this;\n  }\n\n  onMessage(pattern: string | RegExp, text: string, opts?: { delayMs?: number }): this {\n    const events = buildTextResponse(text);\n    this.fixtures.push({\n      match: { message: pattern },\n      events,\n      delayMs: opts?.delayMs,\n    });\n    return this;\n  }\n\n  onRun(pattern: string | RegExp, events: AGUIEvent[], delayMs?: number): this {\n    this.fixtures.push({\n      match: { message: pattern },\n      events,\n      delayMs,\n    });\n    return this;\n  }\n\n  onToolCall(\n    pattern: string | RegExp,\n    toolName: string,\n    args: string,\n    opts?: { result?: string; delayMs?: number },\n  ): this {\n    const events = buildToolCallResponse(toolName, args, {\n      result: opts?.result,\n    });\n    this.fixtures.push({\n      match: { message: pattern },\n      events,\n      delayMs: opts?.delayMs,\n    });\n    return this;\n  }\n\n  onStateKey(key: string, snapshot: Record<string, unknown>, delayMs?: number): this {\n    const events = buildStateUpdate(snapshot);\n    this.fixtures.push({\n      match: { stateKey: key },\n      events,\n      delayMs,\n    });\n    return this;\n  }\n\n  onReasoning(pattern: string | RegExp, text: string, opts?: { delayMs?: number }): this {\n    const events = buildReasoningResponse(text);\n    this.fixtures.push({\n      match: { message: pattern },\n      events,\n      delayMs: opts?.delayMs,\n    });\n    return this;\n  }\n\n  onPredicate(\n    predicate: (input: AGUIRunAgentInput) => boolean,\n    events: AGUIEvent[],\n    delayMs?: number,\n  ): this {\n    this.fixtures.push({\n      match: { predicate },\n      events,\n      delayMs,\n    });\n    return this;\n  }\n\n  onToolResult(toolCallId: string, events: AGUIEvent[], delayMs?: number): this {\n    this.fixtures.push({\n      match: { toolCallId },\n      events,\n      delayMs,\n    });\n    return this;\n  }\n\n  enableRecording(config: AGUIRecordConfig): this {\n    this.recordConfig = config;\n    return this;\n  }\n\n  reset(): this {\n    this.fixtures = [];\n    this.recordConfig = undefined;\n    return this;\n  }\n\n  // ---- Mountable interface ----\n\n  async handleRequest(\n    req: http.IncomingMessage,\n    res: http.ServerResponse,\n    pathname: string,\n  ): Promise<boolean> {\n    if (req.method !== \"POST\" || (pathname !== \"/\" && pathname !== \"\")) {\n      return false;\n    }\n\n    if (this.registry) {\n      this.registry.incrementCounter(\"aimock_agui_requests_total\", { method: \"POST\" });\n    }\n\n    let body: string;\n    try {\n      body = await readBody(req);\n    } catch (err) {\n      res.writeHead(400, { \"Content-Type\": \"application/json\" });\n      const detail = err instanceof Error ? err.message : \"body read failed\";\n      res.end(JSON.stringify({ error: `Failed to read request body: ${detail}` }));\n      this.journalRequest(req, pathname, 400);\n      return true;\n    }\n\n    let input: AGUIRunAgentInput;\n    try {\n      input = JSON.parse(body) as AGUIRunAgentInput;\n    } catch (err) {\n      res.writeHead(400, { \"Content-Type\": \"application/json\" });\n      const detail = err instanceof Error ? err.message : \"unknown parse error\";\n      res.end(JSON.stringify({ error: `Invalid JSON body: ${detail}` }));\n      this.journalRequest(req, pathname, 400);\n      return true;\n    }\n\n    if (input.messages !== undefined && !Array.isArray(input.messages)) {\n      res.writeHead(400, { \"Content-Type\": \"application/json\" });\n      res.end(\n        JSON.stringify({\n          error: \"Invalid input: 'messages' must be an array when provided\",\n        }),\n      );\n      this.journalRequest(req, pathname, 400);\n      return true;\n    }\n\n    const fixture = findFixture(input, this.fixtures);\n\n    if (fixture) {\n      await writeAGUIEventStream(res, fixture.events, { delayMs: fixture.delayMs });\n      this.journalRequest(req, pathname, 200);\n      return true;\n    }\n\n    // No match — if recording is enabled, proxy to upstream\n    if (this.recordConfig) {\n      const result = await proxyAndRecordAGUI(\n        req,\n        res,\n        input,\n        this.fixtures,\n        this.recordConfig,\n        this.logger,\n        body,\n      );\n      if (result !== false) {\n        this.journalRequest(req, pathname, result);\n        return true;\n      }\n    }\n\n    // No match, no recorder — 404\n    res.writeHead(404, { \"Content-Type\": \"application/json\" });\n    res.end(JSON.stringify({ error: \"No matching AG-UI fixture\" }));\n    this.journalRequest(req, pathname, 404);\n    return true;\n  }\n\n  health(): { status: string; fixtures: number } {\n    return {\n      status: \"ok\",\n      fixtures: this.fixtures.length,\n    };\n  }\n\n  setJournal(journal: Journal): void {\n    this.journal = journal;\n  }\n\n  setBaseUrl(url: string): void {\n    this.baseUrl = url;\n  }\n\n  setRegistry(registry: MetricsRegistry): void {\n    this.registry = registry;\n  }\n\n  // ---- Standalone mode ----\n\n  async start(): Promise<string> {\n    if (this.server) {\n      throw new Error(\"AGUIMock server already started\");\n    }\n\n    const host = this.options.host ?? \"127.0.0.1\";\n    const port = this.options.port ?? 0;\n\n    return new Promise<string>((resolve, reject) => {\n      const srv = http.createServer(async (req, res) => {\n        const url = new URL(req.url ?? \"/\", `http://${req.headers.host ?? \"localhost\"}`);\n        const handled = await this.handleRequest(req, res, url.pathname).catch((err) => {\n          this.logger.error(`AGUIMock request error: ${err instanceof Error ? err.message : err}`);\n          if (!res.headersSent) {\n            res.writeHead(500);\n            res.end(\"Internal server error\");\n          } else if (!res.writableEnded) {\n            res.end();\n          }\n          this.journalRequest(req, url.pathname, res.statusCode);\n          return true;\n        });\n        if (!handled && !res.headersSent) {\n          res.writeHead(404, { \"Content-Type\": \"application/json\" });\n          res.end(JSON.stringify({ error: \"Not found\" }));\n          this.journalRequest(req, url.pathname, 404);\n        }\n      });\n\n      srv.on(\"error\", reject);\n\n      srv.listen(port, host, () => {\n        const addr = srv.address();\n        if (typeof addr === \"object\" && addr !== null) {\n          this.baseUrl = `http://${host}:${addr.port}`;\n        }\n        this.server = srv;\n        resolve(this.baseUrl);\n      });\n    });\n  }\n\n  async stop(): Promise<void> {\n    if (!this.server) {\n      throw new Error(\"AGUIMock server not started\");\n    }\n    const srv = this.server;\n    await new Promise<void>((resolve, reject) => {\n      srv.close((err: Error | undefined) => (err ? reject(err) : resolve()));\n    });\n    this.server = null;\n  }\n\n  get url(): string {\n    if (!this.server) {\n      throw new Error(\"AGUIMock server not started\");\n    }\n    return this.baseUrl;\n  }\n\n  // ---- Private helpers ----\n\n  private journalRequest(req: http.IncomingMessage, pathname: string, status: number): void {\n    if (this.journal) {\n      this.journal.add({\n        method: req.method ?? \"POST\",\n        path: req.url ?? pathname,\n        headers: flattenHeaders(req.headers),\n        body: null,\n        service: \"agui\",\n        response: { status, fixture: null },\n      });\n    }\n  }\n}\n"],"mappings":"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"}

package/dist/agui-mock.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"agui-mock.d.cts","names":[],"sources":["../src/agui-mock.ts"],"sourcesContent":[],"mappings":";;;;;;;cAuBa,QAAA,YAAoB;;EAApB,QAAA,MAAS;EAAA,QAAA,OAAA;UAUE,QAAA;UAOF,OAAA;UAKQ,OAAA;UAUJ,YAAA;UAAgB,MAAA;aAUpB,CAAA,OAAA,CAAA,EAhCE,eAgCF;YAgBc,CAAA,OAAA,EAzCd,WAyCc,CAAA,EAAA,IAAA;WAUJ,CAAA,OAAA,EAAA,MAAA,GA9CF,MA8CE,EAAA,IAAA,EAAA,MAAA,EAAA,KAAA,EAAA;IAWT,OAAA,CAAA,EAAA,MAAA;MACX,IAAA;OAW+B,CAAA,OAAA,EAAA,MAAA,GA3DjB,MA2DiB,EAAA,MAAA,EA3DD,SA2DC,EAAA,EAAA,OAAA,CAAA,EAAA,MAAA,CAAA,EAAA,IAAA;YASjB,CAAA,OAAA,EAAA,MAAA,GA1DJ,MA0DI,EAAA,QAAA,EAAA,MAAA,EAAA,IAAA,EAAA,MAAA,EAAA,KAAA,EAAA;IAcjB,MAAK,CAAA,EAAA,MAAA;IACL,OAAK,CAAA,EAAA,MAAA;MAET,IAAA;YAgFiB,CAAA,GAAA,EAAA,MAAA,EAAA,QAAA,EA3Ic,MA2Id,CAAA,MAAA,EAAA,OAAA,CAAA,EAAA,OAAA,CAAA,EAAA,MAAA,CAAA,EAAA,IAAA;aAQE,CAAA,OAAA,EAAA,MAAA,GAzIQ,MAyIR,EAAA,IAAA,EAAA,MAAA,EAAA,KAAA,EAAA;IAMP,OAAA,CAAA,EAAA,MAAA;MA0CD,IAAA;aA7PiB,CAAA,SAAA,EAAA,CAAA,KAAA,EA+EV,iBA/EU,EAAA,GAAA,OAAA,EAAA,MAAA,EAgFrB,SAhFqB,EAAA,EAAA,OAAA,CAAA,EAAA,MAAA,CAAA,EAAA,IAAA;EAAS,YAAA,CAAA,UAAA,EAAA,MAAA,EAAA,MAAA,EA2FC,SA3FD,EAAA,EAAA,OAAA,CAAA,EAAA,MAAA,CAAA,EAAA,IAAA;0BAoGhB;;qBAcjB,MAAA,CAAK,sBACL,MAAA,CAAK,mCAET;;;;;sBAgFiB;;wBAQE;WAMP;UA0CD"}
+{"version":3,"file":"agui-mock.d.cts","names":[],"sources":["../src/agui-mock.ts"],"sourcesContent":[],"mappings":";;;;;;;cAuBa,QAAA,YAAoB;;EAApB,QAAA,MAAS;EAAA,QAAA,OAAA;UAUE,QAAA;UAOF,OAAA;UAKQ,OAAA;UAUJ,YAAA;UAAgB,MAAA;aAUpB,CAAA,OAAA,CAAA,EAhCE,eAgCF;YAgBc,CAAA,OAAA,EAzCd,WAyCc,CAAA,EAAA,IAAA;WAUJ,CAAA,OAAA,EAAA,MAAA,GA9CF,MA8CE,EAAA,IAAA,EAAA,MAAA,EAAA,KAAA,EAAA;IAWT,OAAA,CAAA,EAAA,MAAA;MACX,IAAA;OAW+B,CAAA,OAAA,EAAA,MAAA,GA3DjB,MA2DiB,EAAA,MAAA,EA3DD,SA2DC,EAAA,EAAA,OAAA,CAAA,EAAA,MAAA,CAAA,EAAA,IAAA;YASjB,CAAA,OAAA,EAAA,MAAA,GA1DJ,MA0DI,EAAA,QAAA,EAAA,MAAA,EAAA,IAAA,EAAA,MAAA,EAAA,KAAA,EAAA;IAcjB,MAAK,CAAA,EAAA,MAAA;IACL,OAAK,CAAA,EAAA,MAAA;MAET,IAAA;YAiFiB,CAAA,GAAA,EAAA,MAAA,EAAA,QAAA,EA5Ic,MA4Id,CAAA,MAAA,EAAA,OAAA,CAAA,EAAA,OAAA,CAAA,EAAA,MAAA,CAAA,EAAA,IAAA;aAQE,CAAA,OAAA,EAAA,MAAA,GA1IQ,MA0IR,EAAA,IAAA,EAAA,MAAA,EAAA,KAAA,EAAA;IAMP,OAAA,CAAA,EAAA,MAAA;MA0CD,IAAA;aA9PiB,CAAA,SAAA,EAAA,CAAA,KAAA,EA+EV,iBA/EU,EAAA,GAAA,OAAA,EAAA,MAAA,EAgFrB,SAhFqB,EAAA,EAAA,OAAA,CAAA,EAAA,MAAA,CAAA,EAAA,IAAA;EAAS,YAAA,CAAA,UAAA,EAAA,MAAA,EAAA,MAAA,EA2FC,SA3FD,EAAA,EAAA,OAAA,CAAA,EAAA,MAAA,CAAA,EAAA,IAAA;0BAoGhB;;qBAcjB,MAAA,CAAK,sBACL,MAAA,CAAK,mCAET;;;;;sBAiFiB;;wBAQE;WAMP;UA0CD"}

package/dist/agui-mock.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agui-mock.d.ts","names":[],"sources":["../src/agui-mock.ts"],"sourcesContent":[],"mappings":";;;;;;;cAuBa,QAAA,YAAoB;;EAApB,QAAA,MAAS;EAAA,QAAA,OAAA;UAUE,QAAA;UAOF,OAAA;UAKQ,OAAA;UAUJ,YAAA;UAAgB,MAAA;aAUpB,CAAA,OAAA,CAAA,EAhCE,eAgCF;YAgBc,CAAA,OAAA,EAzCd,WAyCc,CAAA,EAAA,IAAA;WAUJ,CAAA,OAAA,EAAA,MAAA,GA9CF,MA8CE,EAAA,IAAA,EAAA,MAAA,EAAA,KAAA,EAAA;IAWT,OAAA,CAAA,EAAA,MAAA;MACX,IAAA;OAW+B,CAAA,OAAA,EAAA,MAAA,GA3DjB,MA2DiB,EAAA,MAAA,EA3DD,SA2DC,EAAA,EAAA,OAAA,CAAA,EAAA,MAAA,CAAA,EAAA,IAAA;YASjB,CAAA,OAAA,EAAA,MAAA,GA1DJ,MA0DI,EAAA,QAAA,EAAA,MAAA,EAAA,IAAA,EAAA,MAAA,EAAA,KAAA,EAAA;IAcjB,MAAK,CAAA,EAAA,MAAA;IACL,OAAK,CAAA,EAAA,MAAA;MAET,IAAA;YAgFiB,CAAA,GAAA,EAAA,MAAA,EAAA,QAAA,EA3Ic,MA2Id,CAAA,MAAA,EAAA,OAAA,CAAA,EAAA,OAAA,CAAA,EAAA,MAAA,CAAA,EAAA,IAAA;aAQE,CAAA,OAAA,EAAA,MAAA,GAzIQ,MAyIR,EAAA,IAAA,EAAA,MAAA,EAAA,KAAA,EAAA;IAMP,OAAA,CAAA,EAAA,MAAA;MA0CD,IAAA;aA7PiB,CAAA,SAAA,EAAA,CAAA,KAAA,EA+EV,iBA/EU,EAAA,GAAA,OAAA,EAAA,MAAA,EAgFrB,SAhFqB,EAAA,EAAA,OAAA,CAAA,EAAA,MAAA,CAAA,EAAA,IAAA;EAAS,YAAA,CAAA,UAAA,EAAA,MAAA,EAAA,MAAA,EA2FC,SA3FD,EAAA,EAAA,OAAA,CAAA,EAAA,MAAA,CAAA,EAAA,IAAA;0BAoGhB;;qBAcjB,MAAA,CAAK,sBACL,MAAA,CAAK,mCAET;;;;;sBAgFiB;;wBAQE;WAMP;UA0CD"}
+{"version":3,"file":"agui-mock.d.ts","names":[],"sources":["../src/agui-mock.ts"],"sourcesContent":[],"mappings":";;;;;;;cAuBa,QAAA,YAAoB;;EAApB,QAAA,MAAS;EAAA,QAAA,OAAA;UAUE,QAAA;UAOF,OAAA;UAKQ,OAAA;UAUJ,YAAA;UAAgB,MAAA;aAUpB,CAAA,OAAA,CAAA,EAhCE,eAgCF;YAgBc,CAAA,OAAA,EAzCd,WAyCc,CAAA,EAAA,IAAA;WAUJ,CAAA,OAAA,EAAA,MAAA,GA9CF,MA8CE,EAAA,IAAA,EAAA,MAAA,EAAA,KAAA,EAAA;IAWT,OAAA,CAAA,EAAA,MAAA;MACX,IAAA;OAW+B,CAAA,OAAA,EAAA,MAAA,GA3DjB,MA2DiB,EAAA,MAAA,EA3DD,SA2DC,EAAA,EAAA,OAAA,CAAA,EAAA,MAAA,CAAA,EAAA,IAAA;YASjB,CAAA,OAAA,EAAA,MAAA,GA1DJ,MA0DI,EAAA,QAAA,EAAA,MAAA,EAAA,IAAA,EAAA,MAAA,EAAA,KAAA,EAAA;IAcjB,MAAK,CAAA,EAAA,MAAA;IACL,OAAK,CAAA,EAAA,MAAA;MAET,IAAA;YAiFiB,CAAA,GAAA,EAAA,MAAA,EAAA,QAAA,EA5Ic,MA4Id,CAAA,MAAA,EAAA,OAAA,CAAA,EAAA,OAAA,CAAA,EAAA,MAAA,CAAA,EAAA,IAAA;aAQE,CAAA,OAAA,EAAA,MAAA,GA1IQ,MA0IR,EAAA,IAAA,EAAA,MAAA,EAAA,KAAA,EAAA;IAMP,OAAA,CAAA,EAAA,MAAA;MA0CD,IAAA;aA9PiB,CAAA,SAAA,EAAA,CAAA,KAAA,EA+EV,iBA/EU,EAAA,GAAA,OAAA,EAAA,MAAA,EAgFrB,SAhFqB,EAAA,EAAA,OAAA,CAAA,EAAA,MAAA,CAAA,EAAA,IAAA;EAAS,YAAA,CAAA,UAAA,EAAA,MAAA,EAAA,MAAA,EA2FC,SA3FD,EAAA,EAAA,OAAA,CAAA,EAAA,MAAA,CAAA,EAAA,IAAA;0BAoGhB;;qBAcjB,MAAA,CAAK,sBACL,MAAA,CAAK,mCAET;;;;;sBAiFiB;;wBAQE;WAMP;UA0CD"}

package/dist/agui-mock.js

@@ -127,7 +127,7 @@ var AGUIMock = class {
 			return true;
 		}
 		if (this.recordConfig) {
-			const result = await proxyAndRecordAGUI(req, res, input, this.fixtures, this.recordConfig, this.logger);
+			const result = await proxyAndRecordAGUI(req, res, input, this.fixtures, this.recordConfig, this.logger, body);
 			if (result !== false) {
 				this.journalRequest(req, pathname, result);
 				return true;

package/dist/agui-mock.js.map

@@ -1 +1 @@
-{"version":3,"file":"agui-mock.js","names":["http"],"sources":["../src/agui-mock.ts"],"sourcesContent":["import * as http from \"node:http\";\nimport type { Mountable } from \"./types.js\";\nimport type { Journal } from \"./journal.js\";\nimport type { MetricsRegistry } from \"./metrics.js\";\nimport type {\n  AGUIFixture,\n  AGUIMockOptions,\n  AGUIRecordConfig,\n  AGUIEvent,\n  AGUIRunAgentInput,\n} from \"./agui-types.js\";\nimport {\n  findFixture,\n  buildTextResponse,\n  buildToolCallResponse,\n  buildStateUpdate,\n  buildReasoningResponse,\n  writeAGUIEventStream,\n} from \"./agui-handler.js\";\nimport { flattenHeaders, readBody } from \"./helpers.js\";\nimport { proxyAndRecordAGUI } from \"./agui-recorder.js\";\nimport { Logger, type LogLevel } from \"./logger.js\";\n\nexport class AGUIMock implements Mountable {\n  private fixtures: AGUIFixture[] = [];\n  private server: http.Server | null = null;\n  private journal: Journal | null = null;\n  private registry: MetricsRegistry | null = null;\n  private options: AGUIMockOptions;\n  private baseUrl = \"\";\n  private recordConfig: AGUIRecordConfig | undefined;\n  private logger: Logger;\n\n  constructor(options?: AGUIMockOptions) {\n    this.options = options ?? {};\n    this.logger = new Logger((options?.logLevel as LogLevel) ?? \"warn\");\n  }\n\n  // ---- Fluent registration API ----\n\n  addFixture(fixture: AGUIFixture): this {\n    this.fixtures.push(fixture);\n    return this;\n  }\n\n  onMessage(pattern: string | RegExp, text: string, opts?: { delayMs?: number }): this {\n    const events = buildTextResponse(text);\n    this.fixtures.push({\n      match: { message: pattern },\n      events,\n      delayMs: opts?.delayMs,\n    });\n    return this;\n  }\n\n  onRun(pattern: string | RegExp, events: AGUIEvent[], delayMs?: number): this {\n    this.fixtures.push({\n      match: { message: pattern },\n      events,\n      delayMs,\n    });\n    return this;\n  }\n\n  onToolCall(\n    pattern: string | RegExp,\n    toolName: string,\n    args: string,\n    opts?: { result?: string; delayMs?: number },\n  ): this {\n    const events = buildToolCallResponse(toolName, args, {\n      result: opts?.result,\n    });\n    this.fixtures.push({\n      match: { message: pattern },\n      events,\n      delayMs: opts?.delayMs,\n    });\n    return this;\n  }\n\n  onStateKey(key: string, snapshot: Record<string, unknown>, delayMs?: number): this {\n    const events = buildStateUpdate(snapshot);\n    this.fixtures.push({\n      match: { stateKey: key },\n      events,\n      delayMs,\n    });\n    return this;\n  }\n\n  onReasoning(pattern: string | RegExp, text: string, opts?: { delayMs?: number }): this {\n    const events = buildReasoningResponse(text);\n    this.fixtures.push({\n      match: { message: pattern },\n      events,\n      delayMs: opts?.delayMs,\n    });\n    return this;\n  }\n\n  onPredicate(\n    predicate: (input: AGUIRunAgentInput) => boolean,\n    events: AGUIEvent[],\n    delayMs?: number,\n  ): this {\n    this.fixtures.push({\n      match: { predicate },\n      events,\n      delayMs,\n    });\n    return this;\n  }\n\n  onToolResult(toolCallId: string, events: AGUIEvent[], delayMs?: number): this {\n    this.fixtures.push({\n      match: { toolCallId },\n      events,\n      delayMs,\n    });\n    return this;\n  }\n\n  enableRecording(config: AGUIRecordConfig): this {\n    this.recordConfig = config;\n    return this;\n  }\n\n  reset(): this {\n    this.fixtures = [];\n    this.recordConfig = undefined;\n    return this;\n  }\n\n  // ---- Mountable interface ----\n\n  async handleRequest(\n    req: http.IncomingMessage,\n    res: http.ServerResponse,\n    pathname: string,\n  ): Promise<boolean> {\n    if (req.method !== \"POST\" || (pathname !== \"/\" && pathname !== \"\")) {\n      return false;\n    }\n\n    if (this.registry) {\n      this.registry.incrementCounter(\"aimock_agui_requests_total\", { method: \"POST\" });\n    }\n\n    let body: string;\n    try {\n      body = await readBody(req);\n    } catch (err) {\n      res.writeHead(400, { \"Content-Type\": \"application/json\" });\n      const detail = err instanceof Error ? err.message : \"body read failed\";\n      res.end(JSON.stringify({ error: `Failed to read request body: ${detail}` }));\n      this.journalRequest(req, pathname, 400);\n      return true;\n    }\n\n    let input: AGUIRunAgentInput;\n    try {\n      input = JSON.parse(body) as AGUIRunAgentInput;\n    } catch (err) {\n      res.writeHead(400, { \"Content-Type\": \"application/json\" });\n      const detail = err instanceof Error ? err.message : \"unknown parse error\";\n      res.end(JSON.stringify({ error: `Invalid JSON body: ${detail}` }));\n      this.journalRequest(req, pathname, 400);\n      return true;\n    }\n\n    if (input.messages !== undefined && !Array.isArray(input.messages)) {\n      res.writeHead(400, { \"Content-Type\": \"application/json\" });\n      res.end(\n        JSON.stringify({\n          error: \"Invalid input: 'messages' must be an array when provided\",\n        }),\n      );\n      this.journalRequest(req, pathname, 400);\n      return true;\n    }\n\n    const fixture = findFixture(input, this.fixtures);\n\n    if (fixture) {\n      await writeAGUIEventStream(res, fixture.events, { delayMs: fixture.delayMs });\n      this.journalRequest(req, pathname, 200);\n      return true;\n    }\n\n    // No match — if recording is enabled, proxy to upstream\n    if (this.recordConfig) {\n      const result = await proxyAndRecordAGUI(\n        req,\n        res,\n        input,\n        this.fixtures,\n        this.recordConfig,\n        this.logger,\n      );\n      if (result !== false) {\n        this.journalRequest(req, pathname, result);\n        return true;\n      }\n    }\n\n    // No match, no recorder — 404\n    res.writeHead(404, { \"Content-Type\": \"application/json\" });\n    res.end(JSON.stringify({ error: \"No matching AG-UI fixture\" }));\n    this.journalRequest(req, pathname, 404);\n    return true;\n  }\n\n  health(): { status: string; fixtures: number } {\n    return {\n      status: \"ok\",\n      fixtures: this.fixtures.length,\n    };\n  }\n\n  setJournal(journal: Journal): void {\n    this.journal = journal;\n  }\n\n  setBaseUrl(url: string): void {\n    this.baseUrl = url;\n  }\n\n  setRegistry(registry: MetricsRegistry): void {\n    this.registry = registry;\n  }\n\n  // ---- Standalone mode ----\n\n  async start(): Promise<string> {\n    if (this.server) {\n      throw new Error(\"AGUIMock server already started\");\n    }\n\n    const host = this.options.host ?? \"127.0.0.1\";\n    const port = this.options.port ?? 0;\n\n    return new Promise<string>((resolve, reject) => {\n      const srv = http.createServer(async (req, res) => {\n        const url = new URL(req.url ?? \"/\", `http://${req.headers.host ?? \"localhost\"}`);\n        const handled = await this.handleRequest(req, res, url.pathname).catch((err) => {\n          this.logger.error(`AGUIMock request error: ${err instanceof Error ? err.message : err}`);\n          if (!res.headersSent) {\n            res.writeHead(500);\n            res.end(\"Internal server error\");\n          } else if (!res.writableEnded) {\n            res.end();\n          }\n          this.journalRequest(req, url.pathname, res.statusCode);\n          return true;\n        });\n        if (!handled && !res.headersSent) {\n          res.writeHead(404, { \"Content-Type\": \"application/json\" });\n          res.end(JSON.stringify({ error: \"Not found\" }));\n          this.journalRequest(req, url.pathname, 404);\n        }\n      });\n\n      srv.on(\"error\", reject);\n\n      srv.listen(port, host, () => {\n        const addr = srv.address();\n        if (typeof addr === \"object\" && addr !== null) {\n          this.baseUrl = `http://${host}:${addr.port}`;\n        }\n        this.server = srv;\n        resolve(this.baseUrl);\n      });\n    });\n  }\n\n  async stop(): Promise<void> {\n    if (!this.server) {\n      throw new Error(\"AGUIMock server not started\");\n    }\n    const srv = this.server;\n    await new Promise<void>((resolve, reject) => {\n      srv.close((err: Error | undefined) => (err ? reject(err) : resolve()));\n    });\n    this.server = null;\n  }\n\n  get url(): string {\n    if (!this.server) {\n      throw new Error(\"AGUIMock server not started\");\n    }\n    return this.baseUrl;\n  }\n\n  // ---- Private helpers ----\n\n  private journalRequest(req: http.IncomingMessage, pathname: string, status: number): void {\n    if (this.journal) {\n      this.journal.add({\n        method: req.method ?? \"POST\",\n        path: req.url ?? pathname,\n        headers: flattenHeaders(req.headers),\n        body: null,\n        service: \"agui\",\n        response: { status, fixture: null },\n      });\n    }\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"agui-mock.js","names":["http"],"sources":["../src/agui-mock.ts"],"sourcesContent":["import * as http from \"node:http\";\nimport type { Mountable } from \"./types.js\";\nimport type { Journal } from \"./journal.js\";\nimport type { MetricsRegistry } from \"./metrics.js\";\nimport type {\n  AGUIFixture,\n  AGUIMockOptions,\n  AGUIRecordConfig,\n  AGUIEvent,\n  AGUIRunAgentInput,\n} from \"./agui-types.js\";\nimport {\n  findFixture,\n  buildTextResponse,\n  buildToolCallResponse,\n  buildStateUpdate,\n  buildReasoningResponse,\n  writeAGUIEventStream,\n} from \"./agui-handler.js\";\nimport { flattenHeaders, readBody } from \"./helpers.js\";\nimport { proxyAndRecordAGUI } from \"./agui-recorder.js\";\nimport { Logger, type LogLevel } from \"./logger.js\";\n\nexport class AGUIMock implements Mountable {\n  private fixtures: AGUIFixture[] = [];\n  private server: http.Server | null = null;\n  private journal: Journal | null = null;\n  private registry: MetricsRegistry | null = null;\n  private options: AGUIMockOptions;\n  private baseUrl = \"\";\n  private recordConfig: AGUIRecordConfig | undefined;\n  private logger: Logger;\n\n  constructor(options?: AGUIMockOptions) {\n    this.options = options ?? {};\n    this.logger = new Logger((options?.logLevel as LogLevel) ?? \"warn\");\n  }\n\n  // ---- Fluent registration API ----\n\n  addFixture(fixture: AGUIFixture): this {\n    this.fixtures.push(fixture);\n    return this;\n  }\n\n  onMessage(pattern: string | RegExp, text: string, opts?: { delayMs?: number }): this {\n    const events = buildTextResponse(text);\n    this.fixtures.push({\n      match: { message: pattern },\n      events,\n      delayMs: opts?.delayMs,\n    });\n    return this;\n  }\n\n  onRun(pattern: string | RegExp, events: AGUIEvent[], delayMs?: number): this {\n    this.fixtures.push({\n      match: { message: pattern },\n      events,\n      delayMs,\n    });\n    return this;\n  }\n\n  onToolCall(\n    pattern: string | RegExp,\n    toolName: string,\n    args: string,\n    opts?: { result?: string; delayMs?: number },\n  ): this {\n    const events = buildToolCallResponse(toolName, args, {\n      result: opts?.result,\n    });\n    this.fixtures.push({\n      match: { message: pattern },\n      events,\n      delayMs: opts?.delayMs,\n    });\n    return this;\n  }\n\n  onStateKey(key: string, snapshot: Record<string, unknown>, delayMs?: number): this {\n    const events = buildStateUpdate(snapshot);\n    this.fixtures.push({\n      match: { stateKey: key },\n      events,\n      delayMs,\n    });\n    return this;\n  }\n\n  onReasoning(pattern: string | RegExp, text: string, opts?: { delayMs?: number }): this {\n    const events = buildReasoningResponse(text);\n    this.fixtures.push({\n      match: { message: pattern },\n      events,\n      delayMs: opts?.delayMs,\n    });\n    return this;\n  }\n\n  onPredicate(\n    predicate: (input: AGUIRunAgentInput) => boolean,\n    events: AGUIEvent[],\n    delayMs?: number,\n  ): this {\n    this.fixtures.push({\n      match: { predicate },\n      events,\n      delayMs,\n    });\n    return this;\n  }\n\n  onToolResult(toolCallId: string, events: AGUIEvent[], delayMs?: number): this {\n    this.fixtures.push({\n      match: { toolCallId },\n      events,\n      delayMs,\n    });\n    return this;\n  }\n\n  enableRecording(config: AGUIRecordConfig): this {\n    this.recordConfig = config;\n    return this;\n  }\n\n  reset(): this {\n    this.fixtures = [];\n    this.recordConfig = undefined;\n    return this;\n  }\n\n  // ---- Mountable interface ----\n\n  async handleRequest(\n    req: http.IncomingMessage,\n    res: http.ServerResponse,\n    pathname: string,\n  ): Promise<boolean> {\n    if (req.method !== \"POST\" || (pathname !== \"/\" && pathname !== \"\")) {\n      return false;\n    }\n\n    if (this.registry) {\n      this.registry.incrementCounter(\"aimock_agui_requests_total\", { method: \"POST\" });\n    }\n\n    let body: string;\n    try {\n      body = await readBody(req);\n    } catch (err) {\n      res.writeHead(400, { \"Content-Type\": \"application/json\" });\n      const detail = err instanceof Error ? err.message : \"body read failed\";\n      res.end(JSON.stringify({ error: `Failed to read request body: ${detail}` }));\n      this.journalRequest(req, pathname, 400);\n      return true;\n    }\n\n    let input: AGUIRunAgentInput;\n    try {\n      input = JSON.parse(body) as AGUIRunAgentInput;\n    } catch (err) {\n      res.writeHead(400, { \"Content-Type\": \"application/json\" });\n      const detail = err instanceof Error ? err.message : \"unknown parse error\";\n      res.end(JSON.stringify({ error: `Invalid JSON body: ${detail}` }));\n      this.journalRequest(req, pathname, 400);\n      return true;\n    }\n\n    if (input.messages !== undefined && !Array.isArray(input.messages)) {\n      res.writeHead(400, { \"Content-Type\": \"application/json\" });\n      res.end(\n        JSON.stringify({\n          error: \"Invalid input: 'messages' must be an array when provided\",\n        }),\n      );\n      this.journalRequest(req, pathname, 400);\n      return true;\n    }\n\n    const fixture = findFixture(input, this.fixtures);\n\n    if (fixture) {\n      await writeAGUIEventStream(res, fixture.events, { delayMs: fixture.delayMs });\n      this.journalRequest(req, pathname, 200);\n      return true;\n    }\n\n    // No match — if recording is enabled, proxy to upstream\n    if (this.recordConfig) {\n      const result = await proxyAndRecordAGUI(\n        req,\n        res,\n        input,\n        this.fixtures,\n        this.recordConfig,\n        this.logger,\n        body,\n      );\n      if (result !== false) {\n        this.journalRequest(req, pathname, result);\n        return true;\n      }\n    }\n\n    // No match, no recorder — 404\n    res.writeHead(404, { \"Content-Type\": \"application/json\" });\n    res.end(JSON.stringify({ error: \"No matching AG-UI fixture\" }));\n    this.journalRequest(req, pathname, 404);\n    return true;\n  }\n\n  health(): { status: string; fixtures: number } {\n    return {\n      status: \"ok\",\n      fixtures: this.fixtures.length,\n    };\n  }\n\n  setJournal(journal: Journal): void {\n    this.journal = journal;\n  }\n\n  setBaseUrl(url: string): void {\n    this.baseUrl = url;\n  }\n\n  setRegistry(registry: MetricsRegistry): void {\n    this.registry = registry;\n  }\n\n  // ---- Standalone mode ----\n\n  async start(): Promise<string> {\n    if (this.server) {\n      throw new Error(\"AGUIMock server already started\");\n    }\n\n    const host = this.options.host ?? \"127.0.0.1\";\n    const port = this.options.port ?? 0;\n\n    return new Promise<string>((resolve, reject) => {\n      const srv = http.createServer(async (req, res) => {\n        const url = new URL(req.url ?? \"/\", `http://${req.headers.host ?? \"localhost\"}`);\n        const handled = await this.handleRequest(req, res, url.pathname).catch((err) => {\n          this.logger.error(`AGUIMock request error: ${err instanceof Error ? err.message : err}`);\n          if (!res.headersSent) {\n            res.writeHead(500);\n            res.end(\"Internal server error\");\n          } else if (!res.writableEnded) {\n            res.end();\n          }\n          this.journalRequest(req, url.pathname, res.statusCode);\n          return true;\n        });\n        if (!handled && !res.headersSent) {\n          res.writeHead(404, { \"Content-Type\": \"application/json\" });\n          res.end(JSON.stringify({ error: \"Not found\" }));\n          this.journalRequest(req, url.pathname, 404);\n        }\n      });\n\n      srv.on(\"error\", reject);\n\n      srv.listen(port, host, () => {\n        const addr = srv.address();\n        if (typeof addr === \"object\" && addr !== null) {\n          this.baseUrl = `http://${host}:${addr.port}`;\n        }\n        this.server = srv;\n        resolve(this.baseUrl);\n      });\n    });\n  }\n\n  async stop(): Promise<void> {\n    if (!this.server) {\n      throw new Error(\"AGUIMock server not started\");\n    }\n    const srv = this.server;\n    await new Promise<void>((resolve, reject) => {\n      srv.close((err: Error | undefined) => (err ? reject(err) : resolve()));\n    });\n    this.server = null;\n  }\n\n  get url(): string {\n    if (!this.server) {\n      throw new Error(\"AGUIMock server not started\");\n    }\n    return this.baseUrl;\n  }\n\n  // ---- Private helpers ----\n\n  private journalRequest(req: http.IncomingMessage, pathname: string, status: number): void {\n    if (this.journal) {\n      this.journal.add({\n        method: req.method ?? \"POST\",\n        path: req.url ?? pathname,\n        headers: flattenHeaders(req.headers),\n        body: null,\n        service: \"agui\",\n        response: { status, fixture: null },\n      });\n    }\n  }\n}\n"],"mappings":"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"}

package/dist/agui-recorder.cjs

@@ -1,6 +1,7 @@
 const require_runtime = require('./_virtual/_rolldown/runtime.cjs');
 const require_api_key_auth = require('./api-key-auth.cjs');
 const require_agui_handler = require('./agui-handler.cjs');
+const require_recorder = require('./recorder.cjs');
 let node_http = require("node:http");
 node_http = require_runtime.__toESM(node_http);
 let node_crypto = require("node:crypto");
@@ -60,10 +61,25 @@ function resolveAGUIRecordBufferCap(configured) {
 * SSE event stream as a fixture on disk and in memory, and relay the
 * response back to the original client in real time.
 *
+* `rawBody` is the exact request payload as it arrived on the wire. It is
+* forwarded byte-for-byte rather than re-serialized from the parsed `input`,
+* because re-serialization changes key order and whitespace and therefore
+* invalidates any signature the caller computed over the body (AWS SigV4 signs
+* a hash of the payload). `input` remains the parsed view used for fixture
+* matching only. It is the LAST parameter so that a pre-existing JavaScript
+* caller omitting it fails loudly here rather than silently shifting an
+* earlier argument into the request body.
+*
 * Returns the HTTP status code written to the client if the request was proxied,
 * or `false` if no upstream is configured.
 */
-async function proxyAndRecordAGUI(req, res, input, fixtures, config, logger) {
+async function proxyAndRecordAGUI(req, res, input, fixtures, config, logger, rawBody) {
+	if (typeof rawBody !== "string") {
+		logger.error("proxyAndRecordAGUI called without the raw request body — cannot proxy");
+		res.writeHead(500, { "Content-Type": "application/json" });
+		res.end(JSON.stringify({ error: "Internal proxy misconfiguration" }));
+		return 500;
+	}
 	if (require_api_key_auth.isAuthenticatedRequest(req)) {
 		res.writeHead(502, { "Content-Type": "application/json" });
 		res.end(JSON.stringify({ error: "No configured provider credential" }));
@@ -84,18 +100,13 @@ async function proxyAndRecordAGUI(req, res, input, fixtures, config, logger) {
 		return 502;
 	}
 	logger.warn(`NO AG-UI FIXTURE MATCH — proxying to ${config.upstream}`);
-	const forwardHeaders = {
-		"Content-Type": "application/json",
-		Accept: "text/event-stream"
-	};
-	const authorization = req.headers["authorization"];
-	if (authorization) forwardHeaders["Authorization"] = Array.isArray(authorization) ? authorization.join(", ") : authorization;
-	const apiKey = req.headers["x-api-key"];
-	if (apiKey) forwardHeaders["x-api-key"] = Array.isArray(apiKey) ? apiKey.join(", ") : apiKey;
-	const requestBody = JSON.stringify(input);
+	const forwardHeaders = require_recorder.buildForwardHeaders(req);
+	require_recorder.setForwardHeaderDefault(forwardHeaders, "Content-Type", "application/json");
+	require_recorder.removeForwardHeader(forwardHeaders, "Accept");
+	forwardHeaders["Accept"] = "text/event-stream";
 	let status;
 	try {
-		status = await teeUpstreamStream(target, forwardHeaders, requestBody, res, input, fixtures, config, logger);
+		status = await teeUpstreamStream(target, forwardHeaders, rawBody, res, input, fixtures, config, logger);
 	} catch (err) {
 		const msg = err instanceof Error ? err.message : "Unknown proxy error";
 		logger.error(`AG-UI proxy request failed: ${msg}`);
@@ -191,7 +202,18 @@ function teeUpstreamStream(target, headers, body, clientRes, input, fixtures, co
 					resolve(clientStatus);
 					return;
 				}
+				const upstreamContentType = upstreamRes.headers["content-type"] ?? "";
+				if (!/text\/event-stream/i.test(upstreamContentType)) {
+					logger.error(`Upstream answered ${upstreamStatus} with Content-Type "${upstreamContentType || "(none)"}", not text/event-stream — response relayed to the client, recording refused`);
+					resolve(clientStatus);
+					return;
+				}
 				const events = parseSSEEvents(Buffer.concat(chunks).toString(), logger);
+				if (events.length === 0) {
+					logger.error("Upstream event stream contained no parseable AG-UI events — response relayed to the client, recording refused");
+					resolve(clientStatus);
+					return;
+				}
 				let match;
 				const lastToolResult = require_agui_handler.getLastMessageIfToolResult(input);
 				if (lastToolResult?.toolCallId) {