@crvouga/mockingbird-service-bedrock 3.0.0 → 3.1.0

package/CHANGELOG.md

@@ -1,5 +1,15 @@
 # Changelog — @crvouga/mockingbird-service-bedrock
 
+## 3.1.0 (2026-10-08)
+
+### Features
+
+- redesign emulator experience ([d6038c2](https://github.com/crvouga/mockingbird/commit/d6038c27eebbaa1751f02bc9305002a5b1304779))
+
+### Dependencies
+
+- `@crvouga/mockingbird-service-sqlite`
+
 ## 3.0.0 (2026-10-07)
 
 ### ⚠️ Breaking changes
@@ -15,10 +25,6 @@
 - format the emulates records query ([8698872](https://github.com/crvouga/mockingbird/commit/8698872509d06002be5a8fcdc85d79f8462320c3))
 - align rename fixtures and formatting ([69e0bee](https://github.com/crvouga/mockingbird/commit/69e0beefe44c9541e46740d3c177bde832340f90))
 
-### Dependencies
-
-- `@crvouga/mockingbird-service-sqlite`
-
 ## 2.3.0 (2026-10-04)
 
 ### Features

package/DISCOVERY.md

@@ -1,7 +1,7 @@
 # @crvouga/mockingbird-service-bedrock discovery
 
 This is the installed-package index for coding agents and tooling. All relative links resolve
-inside `node_modules/@crvouga/mockingbird-service-bedrock/`; no repository checkout is needed to discover the mock's
+inside `node_modules/@crvouga/mockingbird-service-bedrock/`; no repository checkout is needed to discover the emulator's
 supported surface or documented behavior.
 
 ## Capability and behavior sources
@@ -48,7 +48,7 @@ designed for assertions and diagnosis by consuming test suites.
 ## Report a mismatch or missing capability
 
 Follow the [agent reporting contract](https://github.com/crvouga/mockingbird/blob/main/docs/REPORTING_ISSUES.md). Include package version,
-operation/command, a minimal redacted request, actual mock result, expected oracle result or vendor
+operation/command, a minimal redacted request, actual emulator result, expected oracle result or vendor
 documentation, and whether the mismatch appears in the matrix. Never include keys, tokens,
 customer data, prompts, PHI, card data, or unredacted recordings.
 

package/README.md

@@ -1,13 +1,13 @@
 # @crvouga/mockingbird-service-bedrock
 
-> Familiar calls. Faithful echoes. Part of [Mockingbird](https://github.com/crvouga/mockingbird).
+> Local emulators. Real API contracts. Part of [Mockingbird](https://github.com/crvouga/mockingbird).
 
-Stateful, scriptable mock of **Amazon Bedrock Runtime** for test suites: `Converse`,
+Stateful, scriptable emulator of **Amazon Bedrock Runtime** for test suites: `Converse`,
 `ConverseStream` (byte-exact `application/vnd.amazon.eventstream` frames), `InvokeModel`
 (Anthropic Messages bodies and Titan text embeddings), `InvokeModelWithBidirectionalStream`
 (Nova Sonic over HTTP/2 duplex), and the AgentCore `InvokeHarness` event stream.
 
-The mock never generates language. It replays **scripts**: a test says "when the chat model
+The emulator never generates language. It replays **scripts**: a test says "when the chat model
 sees *dizzy* with `report_rx_symptom` available, emit this `toolUse`; after the tool result
 comes back, say this". Chat turns, approval cards, guardrail blocks, structured output and
 throttles become deterministic and take milliseconds.
@@ -112,7 +112,7 @@ how many calls it answers.
   conversation starts over. `expectToolResult: {name}` makes a turn answer only when the last
   user message carries that tool's result. Nova Sonic counts answers within the session.
 - **A turn** is any of: `text` (streamed in `chunkSize`-character deltas, `delayMsPerChunk`
-  mock-clock ms apart), `reasoning`, `toolUse` (`{name, input, toolUseId?}` or a list), `json`
+  emulator-clock ms apart), `reasoning`, `toolUse` (`{name, input, toolUseId?}` or a list), `json`
   (structured output, rendered in the form the request asked for — see below), `guardrail`
   (`true` or `{text, trace}`: `guardrail_intervened` with Bedrock's refusal text and a trace),
   `toolResult` (harness), `userTranscript` (Nova Sonic), `stopReason`, `usage`, `fault`.
@@ -140,11 +140,11 @@ applies to every model and harness call in the calling namespace):
 | `mid_stream_throttling` | the same with a `throttlingException` frame |
 | `validation_exception` / `validation` | 400 `ValidationException` |
 | `max_tokens` | output cut in half, `stopReason: "max_tokens"` |
-| `latency` (`latencyMs`) | the response starts after 2 s on the mock clock |
+| `latency` (`latencyMs`) | the response starts after 2 s on the emulator clock |
 | `truncated_frame` | the stream stops half-way through a frame (both decoders throw) |
 | `model_timeout`, `service_unavailable`, `access_denied`, `internal_server` | 408 / 503 / 403 / 500 with the matching `x-amzn-ErrorType` |
 
-Chunk pacing and latency wait on the **mock clock**: freeze it (`POST /__admin/clock
+Chunk pacing and latency wait on the **emulator clock**: freeze it (`POST /__admin/clock
 {"freeze": true}`) and advance it to release each chunk, so time-to-first-token tests are exact.
 
 ### Admin (beyond the standard contract)
@@ -182,13 +182,13 @@ cannot add headers, so map each worker's access key id:
 
 | Export | Kind | Description |
 | --- | --- | --- |
-| `BedrockAPI` | class | The in-process mock: `fetch`, `reset`, `scripts()`, `putScripts(scripts, replace?)`, `removeScripts(id?)`, `stats()`. Options: `sqlite`, `now`, `namespace`, `settings`, `scripts`, `sleep`. |
-| `createRuntime` | function | The mock with the full service contract (health, admin, namespaces, SigV4 credentials, presets, scripts). Options: `settings`, `scripts`, `clock`, `seed`, `adminKey`, `onLog`, `sqlite`. |
+| `BedrockAPI` | class | The in-process emulator: `fetch`, `reset`, `scripts()`, `putScripts(scripts, replace?)`, `removeScripts(id?)`, `stats()`. Options: `sqlite`, `now`, `namespace`, `settings`, `scripts`, `sleep`. |
+| `createRuntime` | function | The emulator with the full service contract (health, admin, namespaces, SigV4 credentials, presets, scripts). Options: `settings`, `scripts`, `clock`, `seed`, `adminKey`, `onLog`, `sqlite`. |
 | `BEDROCK_PRESETS` | object | Every named fault preset. |
 | `BEDROCK_NAMESPACE` | string | The service name, `"bedrock"`. |
 | `bedrockError` | function | A Bedrock error response (`status`, `x-amzn-ErrorType`, `{message}`). |
 | `accessKeyCredential` | function | The SigV4 access key id of a request (how credentials map to namespaces). |
-| `clockSleep` | function | A sleep that waits on a (possibly frozen) mock clock. |
+| `clockSleep` | function | A sleep that waits on a (possibly frozen) emulator clock. |
 | `titanEmbedding` | function | The deterministic unit vector Titan answers with. |
 | `sampleSchema` | function | The minimal instance of a JSON Schema (the unscripted structured output). |
 | `parseScript` | function | Validate one script (what `PUT /__admin/scripts` runs). |

package/SUPPORT.md

@@ -3,10 +3,10 @@
 Generated from `openapi.yaml`; do not edit by hand.
 
 - operations in spec: **6**
-- supported by the mock: **5**
+- supported by the emulator: **5**
 - parity enabled: **4**
 
-| operationId | route | mock | parity | notes |
+| operationId | route | emulator | parity | notes |
 | --- | --- | --- | --- | --- |
 | `Converse` | `POST /model/{modelId}/converse` | ✅ supported | ✅ |  |
 | `ConverseStream` | `POST /model/{modelId}/converse-stream` | ✅ supported | ✅ |  |