@crvouga/mockingbird-service-livekit 2.1.0 → 2.3.0

package/CHANGELOG.md

@@ -1,5 +1,38 @@
 # Changelog — @crvouga/mockingbird-service-livekit
 
+## 2.3.0 (2026-10-05)
+
+### Features
+
+- compose mock admin APIs ([952bd1f](https://github.com/crvouga/mockingbird/commit/952bd1f679bd442c9a5348a0d9c4d40ad0ac165c))
+- add Fargate task acceptance mock ([f65fc3f](https://github.com/crvouga/mockingbird/commit/f65fc3f293b2fdb41fd45dd1693a5420c6a5109a))
+- keep resource views live ([82c80e1](https://github.com/crvouga/mockingbird/commit/82c80e110b4aa551a17d0ee451c5d08167755267))
+- add LocalStack free tier mocks ([84b7d0c](https://github.com/crvouga/mockingbird/commit/84b7d0ccf4acc7257bb3c3b466a38e30d5b4ab33))
+- implement github reference semantics ([10143e8](https://github.com/crvouga/mockingbird/commit/10143e8364905d77ccfa188d8b6573b1f1003c56))
+- implement docker attach upgrade handshake ([39ad1a3](https://github.com/crvouga/mockingbird/commit/39ad1a39b47aeb423b11bc96230d59f1f5985fa0))
+- preserve accepted docker mutations across response loss ([c2b2d7d](https://github.com/crvouga/mockingbird/commit/c2b2d7dafffe653b3ae9667ec5019d342a68e802))
+
+### Fixes and improvements
+
+- reconcile combined PR integration ([124d5be](https://github.com/crvouga/mockingbird/commit/124d5bed7576535ff481ce6da7d2369957799665))
+- preserve inferred form headers ([02bdd28](https://github.com/crvouga/mockingbird/commit/02bdd2806a9a934607ecd7ffd0cfbe4f6ba80c91))
+
+### Dependencies
+
+- `@crvouga/mockingbird-service-sqlite`
+
+## 2.2.0 (2026-10-04)
+
+### Features
+
+- add scripted local API mock ([4a76a11](https://github.com/crvouga/mockingbird/commit/4a76a114e2efad45934e0a93cf29576fd418e15c))
+- model room agent dispatches ([fb3bcf1](https://github.com/crvouga/mockingbird/commit/fb3bcf1f1d04975fa4533d95b69e6ba0e348f635))
+
+### Fixes and improvements
+
+- support embedded route parameters ([127cad9](https://github.com/crvouga/mockingbird/commit/127cad997ef106950c1b866070eea191ba54403f))
+- preserve namespace URLs after main sync ([62a15ce](https://github.com/crvouga/mockingbird/commit/62a15ce9bd453069bde69e3a30c91efc01f8871b))
+
 ## 2.1.0 (2026-10-04)
 
 ### Features
@@ -12,10 +45,6 @@
 - fill the embedded viewport ([c1a35a4](https://github.com/crvouga/mockingbird/commit/c1a35a4789389ee9cd06c286d09bd47c4d06c71e))
 - make dialog cleanup immediate ([0c1a3c5](https://github.com/crvouga/mockingbird/commit/0c1a3c5b12584d50c19dcae595b951b8e5417b9c))
 
-### Dependencies
-
-- `@crvouga/mockingbird-service-sqlite`
-
 ## 2.0.0 (2026-10-04)
 
 ### ⚠️ Breaking changes

package/README.md

@@ -2,7 +2,7 @@
 
 > Familiar calls. Faithful echoes. Part of [Mockingbird](https://github.com/crvouga/mockingbird).
 
-Stateful LiveKit mock for `livekit-server-sdk`. It serves Twirp JSON room APIs, validates genuine HS256 LiveKit grants, models participant/track/data state, exposes deterministic SIP and egress controls, and emits correctly signed lifecycle webhooks.
+Stateful LiveKit mock for `livekit-server-sdk`. It serves Twirp JSON room and agent-dispatch APIs, validates genuine HS256 LiveKit grants, models participant/track/data state, exposes deterministic SIP and egress controls, and emits correctly signed lifecycle webhooks.
 
 ## Install
 
@@ -25,6 +25,8 @@ const health = await fetch(`${mock.url}/__admin/health`)
 
 Point `RoomServiceClient` at `mock.url`. Supported RoomService calls include CreateRoom, ListRooms, DeleteRoom, UpdateRoomMetadata, ListParticipants, GetParticipant, RemoveParticipant, UpdateParticipant, MutePublishedTrack, and SendData. Room creation is idempotent by name and participant identity is unique within a room.
 
+`AgentDispatchClient` uses the same URL and genuine `roomAdmin` JWTs for `createDispatch`, `listDispatch`, `getDispatch`, and `deleteDispatch`. Both snake_case and camelCase request fields work. A dispatch creates a missing room, starts with no assigned jobs, and preserves its agent name and opaque metadata. Lists read shared room dispatch state, with an optional dispatch-id filter; deleting a dispatch removes its membership. Deleting or expiring a room removes its dispatches. Dispatch/job timestamps are mock-clock Unix seconds encoded as protobuf JSON strings (the SDK exposes bigint values). Tests exercise the existing 2.19.1 SDK and the reporter's exact 2.19.0 over HTTP.
+
 ## Controls
 
 - `POST /__admin/rooms/:room/participants` joins a synthetic participant.
@@ -32,6 +34,8 @@ Point `RoomServiceClient` at `mock.url`. Supported RoomService calls include Cre
 - `POST /__admin/rooms/:room/participants/:identity/tracks` publishes a track.
 - `GET /__admin/rooms/:room/participants/:identity/inbox` inspects targeted data.
 - `GET /__admin/resources` and `POST /__admin/resources/:id/transition` inspect and advance SIP/egress state.
+- `POST /__admin/dispatches/:id/jobs` scripts one room job with `{status?: "JS_PENDING"|"JS_RUNNING"|"JS_SUCCESS"|"JS_FAILED", workerId?, agentId?, participantIdentity?, error?}`. First assignment creates a stable job id; later calls update it and stamp its start/end/update times. The default status is running.
+- Dispatches and jobs participate in namespaces, reset, snapshots, Timeline and fault recovery alongside room state.
 - Fault presets include rate limiting, network loss, and webhook duplicate/reorder/drop delivery.
 
 Webhooks cover room, participant, track, egress, and SIP transitions. Each raw body is signed by a short-lived LiveKit access token whose `sha256` claim is accepted by the official `WebhookReceiver`.
@@ -39,7 +43,7 @@ Webhooks cover room, participant, track, egress, and SIP transitions. Each raw b
 ## API
 
 - `LiveKitAPI`, `LiveKitAPIOptions`, `LiveKitEvent`: handler and event contract.
-- `LiveKitRoom`, `LiveKitParticipant`, `LiveKitTrack`, `DataMessage`, `AsyncResource`: durable state.
+- `LiveKitRoom`, `LiveKitParticipant`, `LiveKitTrack`, `DataMessage`, `AsyncResource`, `AgentDispatch`, `AgentJob`, `JobStatus`: durable state.
 - `createRuntime`, `LiveKitRuntime`, `LiveKitRuntimeOptions`: full runtime and webhook hub.
 - `LIVEKIT_NAMESPACE`, `LIVEKIT_PRESETS`: constants and fault controls.
 - `document`, `operationIds`, `supportedOperationIds`: generated OpenAPI metadata.
@@ -47,6 +51,6 @@ Webhooks cover room, participant, track, egress, and SIP transitions. Each raw b
 
 ## Deliberately not modelled
 
-WebRTC media transport, signaling sockets, transcoding, PSTN calls, production scaling, billing, and dashboards are not modelled. The deterministic server API and lifecycle contract is the initial fidelity boundary.
+Real agent worker registration, job execution, publisher dispatch, restart/deployment policies, WebRTC media transport, signaling sockets, transcoding, PSTN calls, production scaling, billing, and dashboards are not modelled. The deterministic server API and lifecycle contract is the initial fidelity boundary.
 
-Official oracle: [LiveKit RoomService API](https://docs.livekit.io/reference/other/roomservice-api/).
+Official oracles: [LiveKit RoomService API](https://docs.livekit.io/reference/other/roomservice-api/) and [AgentDispatchService API](https://docs.livekit.io/reference/agents/agent-dispatch-service-api/).

package/SUPPORT.md

@@ -2,12 +2,15 @@
 
 Generated from `openapi.yaml`; do not edit by hand.
 
-- operations in spec: **3**
-- supported by the mock: **3**
-- parity enabled: **3**
+- operations in spec: **6**
+- supported by the mock: **6**
+- parity enabled: **6**
 
 | operationId | route | mock | parity | notes |
 | --- | --- | --- | --- | --- |
+| `CreateDispatch` | `POST /twirp/livekit.AgentDispatchService/CreateDispatch` | ✅ supported | ⚠️ unsafe (opt-in) |  |
+| `ListDispatch` | `POST /twirp/livekit.AgentDispatchService/ListDispatch` | ✅ supported | ✅ |  |
+| `DeleteDispatch` | `POST /twirp/livekit.AgentDispatchService/DeleteDispatch` | ✅ supported | ⚠️ unsafe (opt-in) |  |
 | `RoomService` | `POST /twirp/livekit.RoomService/{method}` | ✅ supported | ⚠️ unsafe (opt-in) |  |
 | `EgressService` | `POST /twirp/livekit.Egress/{method}` | ✅ supported | ⚠️ unsafe (opt-in) |  |
 | `SipService` | `POST /twirp/livekit.SIP/{method}` | ✅ supported | ⚠️ unsafe (opt-in) |  |