@crvouga/mockingbird-service-livekit 2.0.0 → 2.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/CHANGELOG.md CHANGED
@@ -1,5 +1,29 @@
1
1
  # Changelog — @crvouga/mockingbird-service-livekit
2
2
 
3
+ ## 2.2.0 (2026-10-05)
4
+
5
+ ### Features
6
+
7
+ - add scripted local API mock ([4a76a11](https://github.com/crvouga/mockingbird/commit/4a76a114e2efad45934e0a93cf29576fd418e15c))
8
+ - model room agent dispatches ([fb3bcf1](https://github.com/crvouga/mockingbird/commit/fb3bcf1f1d04975fa4533d95b69e6ba0e348f635))
9
+
10
+ ### Fixes and improvements
11
+
12
+ - support embedded route parameters ([127cad9](https://github.com/crvouga/mockingbird/commit/127cad997ef106950c1b866070eea191ba54403f))
13
+ - preserve namespace URLs after main sync ([62a15ce](https://github.com/crvouga/mockingbird/commit/62a15ce9bd453069bde69e3a30c91efc01f8871b))
14
+
15
+ ## 2.1.0 (2026-10-04)
16
+
17
+ ### Features
18
+
19
+ - use shared forms for service actions ([af19eb9](https://github.com/crvouga/mockingbird/commit/af19eb9d4896d8418f5db850f20808a89291b949))
20
+ - replace UI with Ant Design ([6547b4e](https://github.com/crvouga/mockingbird/commit/6547b4ef1663fb597ab515cce06245c82010407a))
21
+
22
+ ### Fixes and improvements
23
+
24
+ - fill the embedded viewport ([c1a35a4](https://github.com/crvouga/mockingbird/commit/c1a35a4789389ee9cd06c286d09bd47c4d06c71e))
25
+ - make dialog cleanup immediate ([0c1a3c5](https://github.com/crvouga/mockingbird/commit/0c1a3c5b12584d50c19dcae595b951b8e5417b9c))
26
+
3
27
  ## 2.0.0 (2026-10-04)
4
28
 
5
29
  ### ⚠️ Breaking changes
@@ -18,10 +42,6 @@
18
42
  - parse ISO journal timestamps ([20b39a2](https://github.com/crvouga/mockingbird/commit/20b39a2c738e278533d610dfc91f1cb3ae9b3f1e))
19
43
  - harden shared controls ([7822614](https://github.com/crvouga/mockingbird/commit/7822614f6cba0387aeb60ba7320b0379aa1ef690))
20
44
 
21
- ### Dependencies
22
-
23
- - `@crvouga/mockingbird-service-sqlite`
24
-
25
45
  ## 1.8.0 (2026-10-01)
26
46
 
27
47
  ### Features
package/README.md CHANGED
@@ -2,7 +2,7 @@
2
2
 
3
3
  > Familiar calls. Faithful echoes. Part of [Mockingbird](https://github.com/crvouga/mockingbird).
4
4
 
5
- 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.
5
+ 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.
6
6
 
7
7
  ## Install
8
8
 
@@ -25,6 +25,8 @@ const health = await fetch(`${mock.url}/__admin/health`)
25
25
 
26
26
  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.
27
27
 
28
+ `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.
29
+
28
30
  ## Controls
29
31
 
30
32
  - `POST /__admin/rooms/:room/participants` joins a synthetic participant.
@@ -32,6 +34,8 @@ Point `RoomServiceClient` at `mock.url`. Supported RoomService calls include Cre
32
34
  - `POST /__admin/rooms/:room/participants/:identity/tracks` publishes a track.
33
35
  - `GET /__admin/rooms/:room/participants/:identity/inbox` inspects targeted data.
34
36
  - `GET /__admin/resources` and `POST /__admin/resources/:id/transition` inspect and advance SIP/egress state.
37
+ - `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.
38
+ - Dispatches and jobs participate in namespaces, reset, snapshots, Timeline and fault recovery alongside room state.
35
39
  - Fault presets include rate limiting, network loss, and webhook duplicate/reorder/drop delivery.
36
40
 
37
41
  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
39
43
  ## API
40
44
 
41
45
  - `LiveKitAPI`, `LiveKitAPIOptions`, `LiveKitEvent`: handler and event contract.
42
- - `LiveKitRoom`, `LiveKitParticipant`, `LiveKitTrack`, `DataMessage`, `AsyncResource`: durable state.
46
+ - `LiveKitRoom`, `LiveKitParticipant`, `LiveKitTrack`, `DataMessage`, `AsyncResource`, `AgentDispatch`, `AgentJob`, `JobStatus`: durable state.
43
47
  - `createRuntime`, `LiveKitRuntime`, `LiveKitRuntimeOptions`: full runtime and webhook hub.
44
48
  - `LIVEKIT_NAMESPACE`, `LIVEKIT_PRESETS`: constants and fault controls.
45
49
  - `document`, `operationIds`, `supportedOperationIds`: generated OpenAPI metadata.
@@ -47,6 +51,6 @@ Webhooks cover room, participant, track, egress, and SIP transitions. Each raw b
47
51
 
48
52
  ## Deliberately not modelled
49
53
 
50
- 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.
54
+ 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.
51
55
 
52
- Official oracle: [LiveKit RoomService API](https://docs.livekit.io/reference/other/roomservice-api/).
56
+ 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 CHANGED
@@ -2,12 +2,15 @@
2
2
 
3
3
  Generated from `openapi.yaml`; do not edit by hand.
4
4
 
5
- - operations in spec: **3**
6
- - supported by the mock: **3**
7
- - parity enabled: **3**
5
+ - operations in spec: **6**
6
+ - supported by the mock: **6**
7
+ - parity enabled: **6**
8
8
 
9
9
  | operationId | route | mock | parity | notes |
10
10
  | --- | --- | --- | --- | --- |
11
+ | `CreateDispatch` | `POST /twirp/livekit.AgentDispatchService/CreateDispatch` | ✅ supported | ⚠️ unsafe (opt-in) | |
12
+ | `ListDispatch` | `POST /twirp/livekit.AgentDispatchService/ListDispatch` | ✅ supported | ✅ | |
13
+ | `DeleteDispatch` | `POST /twirp/livekit.AgentDispatchService/DeleteDispatch` | ✅ supported | ⚠️ unsafe (opt-in) | |
11
14
  | `RoomService` | `POST /twirp/livekit.RoomService/{method}` | ✅ supported | ⚠️ unsafe (opt-in) | |
12
15
  | `EgressService` | `POST /twirp/livekit.Egress/{method}` | ✅ supported | ⚠️ unsafe (opt-in) | |
13
16
  | `SipService` | `POST /twirp/livekit.SIP/{method}` | ✅ supported | ⚠️ unsafe (opt-in) | |