@volter/twin-livekit 0.1.0

package/test-fixtures/livekit-openapi-operations.json

@@ -0,0 +1,442 @@
+{
+  "openapi": "3.0.3",
+  "info": {
+    "title": "livekit (operation inventory converted from the protobuf service definitions) (spec-census scoped subset)",
+    "version": "2026-09-02",
+    "description": "A scope-filtered SUBSET of the upstream spec (https://github.com/livekit/protocol), derived by scripts/spec-census-bootstrap.ts: every operation under the committed scopePaths, operation metadata only (operationId, summary, tags, servers) \u2014 schemas AND response codes dropped, which makes this an operation INVENTORY in OpenAPI's shape rather than a valid OpenAPI document: it says which operations exist and nothing about what they answer. It carried the FIRST response code per operation, which reads as the whole set \u2014 diff status codes against the freshly fetched spec instead. It is ONLY the operation-inventory denominator for ../livekit-spec-census.json; see livekit-openapi-operations.SOURCE.md for provenance."
+  },
+  "x-source": {
+    "vendor": "livekit",
+    "upstream": "https://github.com/livekit/protocol",
+    "upstreamFile": "the 22 top-level .proto files of livekit/protocol@09c9697b",
+    "vendored": "derived by scripts/spec-census-bootstrap.ts from the 22 top-level .proto files of livekit/protocol@09c9697b fetched 2026-09-02 \u2014 scope-filtered to scopePaths, schemas and response codes dropped",
+    "curatedOn": "2026-09-02",
+    "scope": "/twirp/livekit.RoomService/, /twirp/livekit.Egress/, /twirp/livekit.Ingress/, /twirp/livekit.SIP/, /twirp/livekit.AgentDispatchService/"
+  },
+  "paths": {
+    "/twirp/livekit.AgentDispatchService/CreateDispatch": {
+      "post": {
+        "operationId": "AgentDispatchService.CreateDispatch",
+        "summary": "",
+        "tags": [
+          "AgentDispatchService"
+        ]
+      }
+    },
+    "/twirp/livekit.AgentDispatchService/DeleteDispatch": {
+      "post": {
+        "operationId": "AgentDispatchService.DeleteDispatch",
+        "summary": "",
+        "tags": [
+          "AgentDispatchService"
+        ]
+      }
+    },
+    "/twirp/livekit.AgentDispatchService/ListDispatch": {
+      "post": {
+        "operationId": "AgentDispatchService.ListDispatch",
+        "summary": "",
+        "tags": [
+          "AgentDispatchService"
+        ]
+      }
+    },
+    "/twirp/livekit.Egress/ListEgress": {
+      "post": {
+        "operationId": "Egress.ListEgress",
+        "summary": "List available egress",
+        "tags": [
+          "Egress"
+        ]
+      }
+    },
+    "/twirp/livekit.Egress/StartEgress": {
+      "post": {
+        "operationId": "Egress.StartEgress",
+        "summary": "Unified StartEgress RPC",
+        "tags": [
+          "Egress"
+        ]
+      }
+    },
+    "/twirp/livekit.Egress/StartParticipantEgress": {
+      "post": {
+        "operationId": "Egress.StartParticipantEgress",
+        "summary": "",
+        "tags": [
+          "Egress"
+        ]
+      }
+    },
+    "/twirp/livekit.Egress/StartRoomCompositeEgress": {
+      "post": {
+        "operationId": "Egress.StartRoomCompositeEgress",
+        "summary": "TODO: deprecate",
+        "tags": [
+          "Egress"
+        ]
+      }
+    },
+    "/twirp/livekit.Egress/StartTrackCompositeEgress": {
+      "post": {
+        "operationId": "Egress.StartTrackCompositeEgress",
+        "summary": "",
+        "tags": [
+          "Egress"
+        ]
+      }
+    },
+    "/twirp/livekit.Egress/StartTrackEgress": {
+      "post": {
+        "operationId": "Egress.StartTrackEgress",
+        "summary": "",
+        "tags": [
+          "Egress"
+        ]
+      }
+    },
+    "/twirp/livekit.Egress/StartWebEgress": {
+      "post": {
+        "operationId": "Egress.StartWebEgress",
+        "summary": "",
+        "tags": [
+          "Egress"
+        ]
+      }
+    },
+    "/twirp/livekit.Egress/StopEgress": {
+      "post": {
+        "operationId": "Egress.StopEgress",
+        "summary": "Stop a recording or stream",
+        "tags": [
+          "Egress"
+        ]
+      }
+    },
+    "/twirp/livekit.Egress/UpdateLayout": {
+      "post": {
+        "operationId": "Egress.UpdateLayout",
+        "summary": "Update url/template or stream outputs",
+        "tags": [
+          "Egress"
+        ]
+      }
+    },
+    "/twirp/livekit.Egress/UpdateStream": {
+      "post": {
+        "operationId": "Egress.UpdateStream",
+        "summary": "",
+        "tags": [
+          "Egress"
+        ]
+      }
+    },
+    "/twirp/livekit.Ingress/CreateIngress": {
+      "post": {
+        "operationId": "Ingress.CreateIngress",
+        "summary": "Create a new Ingress",
+        "tags": [
+          "Ingress"
+        ]
+      }
+    },
+    "/twirp/livekit.Ingress/DeleteIngress": {
+      "post": {
+        "operationId": "Ingress.DeleteIngress",
+        "summary": "",
+        "tags": [
+          "Ingress"
+        ]
+      }
+    },
+    "/twirp/livekit.Ingress/ListIngress": {
+      "post": {
+        "operationId": "Ingress.ListIngress",
+        "summary": "",
+        "tags": [
+          "Ingress"
+        ]
+      }
+    },
+    "/twirp/livekit.Ingress/UpdateIngress": {
+      "post": {
+        "operationId": "Ingress.UpdateIngress",
+        "summary": "Update an existing Ingress",
+        "tags": [
+          "Ingress"
+        ]
+      }
+    },
+    "/twirp/livekit.RoomService/CreateRoom": {
+      "post": {
+        "operationId": "RoomService.CreateRoom",
+        "summary": "Creates a room with settings",
+        "tags": [
+          "RoomService"
+        ]
+      }
+    },
+    "/twirp/livekit.RoomService/DeleteRoom": {
+      "post": {
+        "operationId": "RoomService.DeleteRoom",
+        "summary": "Deletes an existing room by name or id",
+        "tags": [
+          "RoomService"
+        ]
+      }
+    },
+    "/twirp/livekit.RoomService/ForwardParticipant": {
+      "post": {
+        "operationId": "RoomService.ForwardParticipant",
+        "summary": "Cloud-only Forward a connected participant's track(s) to another room",
+        "tags": [
+          "RoomService"
+        ]
+      }
+    },
+    "/twirp/livekit.RoomService/GetParticipant": {
+      "post": {
+        "operationId": "RoomService.GetParticipant",
+        "summary": "Get information on a specific participant, Requires `roomAdmin`",
+        "tags": [
+          "RoomService"
+        ]
+      }
+    },
+    "/twirp/livekit.RoomService/ListParticipants": {
+      "post": {
+        "operationId": "RoomService.ListParticipants",
+        "summary": "Lists participants in a room, Requires `roomAdmin`",
+        "tags": [
+          "RoomService"
+        ]
+      }
+    },
+    "/twirp/livekit.RoomService/ListRooms": {
+      "post": {
+        "operationId": "RoomService.ListRooms",
+        "summary": "List rooms that are active on the server",
+        "tags": [
+          "RoomService"
+        ]
+      }
+    },
+    "/twirp/livekit.RoomService/MoveParticipant": {
+      "post": {
+        "operationId": "RoomService.MoveParticipant",
+        "summary": "Cloud-only Move a connected participant to a different room",
+        "tags": [
+          "RoomService"
+        ]
+      }
+    },
+    "/twirp/livekit.RoomService/MutePublishedTrack": {
+      "post": {
+        "operationId": "RoomService.MutePublishedTrack",
+        "summary": "Mute/unmute a participant's track, Requires `roomAdmin`",
+        "tags": [
+          "RoomService"
+        ]
+      }
+    },
+    "/twirp/livekit.RoomService/PerformRpc": {
+      "post": {
+        "operationId": "RoomService.PerformRpc",
+        "summary": "",
+        "tags": [
+          "RoomService"
+        ]
+      }
+    },
+    "/twirp/livekit.RoomService/RemoveParticipant": {
+      "post": {
+        "operationId": "RoomService.RemoveParticipant",
+        "summary": "Removes a participant from room",
+        "tags": [
+          "RoomService"
+        ]
+      }
+    },
+    "/twirp/livekit.RoomService/SendData": {
+      "post": {
+        "operationId": "RoomService.SendData",
+        "summary": "Send data over data channel to participants in a room, Requires `roomAdmin`",
+        "tags": [
+          "RoomService"
+        ]
+      }
+    },
+    "/twirp/livekit.RoomService/UpdateParticipant": {
+      "post": {
+        "operationId": "RoomService.UpdateParticipant",
+        "summary": "Update participant metadata, will cause updates to be broadcasted to everyone in the room",
+        "tags": [
+          "RoomService"
+        ]
+      }
+    },
+    "/twirp/livekit.RoomService/UpdateRoomMetadata": {
+      "post": {
+        "operationId": "RoomService.UpdateRoomMetadata",
+        "summary": "Update room metadata, will cause updates to be broadcasted to everyone in the room, Requires `roomAdmin`",
+        "tags": [
+          "RoomService"
+        ]
+      }
+    },
+    "/twirp/livekit.RoomService/UpdateSubscriptions": {
+      "post": {
+        "operationId": "RoomService.UpdateSubscriptions",
+        "summary": "Subscribes or unsubscribe a participant from tracks",
+        "tags": [
+          "RoomService"
+        ]
+      }
+    },
+    "/twirp/livekit.SIP/CreateSIPDispatchRule": {
+      "post": {
+        "operationId": "SIP.CreateSIPDispatchRule",
+        "summary": "",
+        "tags": [
+          "SIP"
+        ]
+      }
+    },
+    "/twirp/livekit.SIP/CreateSIPInboundTrunk": {
+      "post": {
+        "operationId": "SIP.CreateSIPInboundTrunk",
+        "summary": "",
+        "tags": [
+          "SIP"
+        ]
+      }
+    },
+    "/twirp/livekit.SIP/CreateSIPOutboundTrunk": {
+      "post": {
+        "operationId": "SIP.CreateSIPOutboundTrunk",
+        "summary": "",
+        "tags": [
+          "SIP"
+        ]
+      }
+    },
+    "/twirp/livekit.SIP/CreateSIPParticipant": {
+      "post": {
+        "operationId": "SIP.CreateSIPParticipant",
+        "summary": "",
+        "tags": [
+          "SIP"
+        ]
+      }
+    },
+    "/twirp/livekit.SIP/DeleteSIPDispatchRule": {
+      "post": {
+        "operationId": "SIP.DeleteSIPDispatchRule",
+        "summary": "",
+        "tags": [
+          "SIP"
+        ]
+      }
+    },
+    "/twirp/livekit.SIP/DeleteSIPTrunk": {
+      "post": {
+        "operationId": "SIP.DeleteSIPTrunk",
+        "summary": "",
+        "tags": [
+          "SIP"
+        ]
+      }
+    },
+    "/twirp/livekit.SIP/GetSIPInboundTrunk": {
+      "post": {
+        "operationId": "SIP.GetSIPInboundTrunk",
+        "summary": "",
+        "tags": [
+          "SIP"
+        ]
+      }
+    },
+    "/twirp/livekit.SIP/GetSIPOutboundTrunk": {
+      "post": {
+        "operationId": "SIP.GetSIPOutboundTrunk",
+        "summary": "",
+        "tags": [
+          "SIP"
+        ]
+      }
+    },
+    "/twirp/livekit.SIP/ListSIPDispatchRule": {
+      "post": {
+        "operationId": "SIP.ListSIPDispatchRule",
+        "summary": "",
+        "tags": [
+          "SIP"
+        ]
+      }
+    },
+    "/twirp/livekit.SIP/ListSIPInboundTrunk": {
+      "post": {
+        "operationId": "SIP.ListSIPInboundTrunk",
+        "summary": "",
+        "tags": [
+          "SIP"
+        ]
+      }
+    },
+    "/twirp/livekit.SIP/ListSIPOutboundTrunk": {
+      "post": {
+        "operationId": "SIP.ListSIPOutboundTrunk",
+        "summary": "",
+        "tags": [
+          "SIP"
+        ]
+      }
+    },
+    "/twirp/livekit.SIP/ListSIPTrunk": {
+      "post": {
+        "operationId": "SIP.ListSIPTrunk",
+        "summary": "",
+        "tags": [
+          "SIP"
+        ],
+        "deprecated": true
+      }
+    },
+    "/twirp/livekit.SIP/TransferSIPParticipant": {
+      "post": {
+        "operationId": "SIP.TransferSIPParticipant",
+        "summary": "",
+        "tags": [
+          "SIP"
+        ]
+      }
+    },
+    "/twirp/livekit.SIP/UpdateSIPDispatchRule": {
+      "post": {
+        "operationId": "SIP.UpdateSIPDispatchRule",
+        "summary": "",
+        "tags": [
+          "SIP"
+        ]
+      }
+    },
+    "/twirp/livekit.SIP/UpdateSIPInboundTrunk": {
+      "post": {
+        "operationId": "SIP.UpdateSIPInboundTrunk",
+        "summary": "",
+        "tags": [
+          "SIP"
+        ]
+      }
+    },
+    "/twirp/livekit.SIP/UpdateSIPOutboundTrunk": {
+      "post": {
+        "operationId": "SIP.UpdateSIPOutboundTrunk",
+        "summary": "",
+        "tags": [
+          "SIP"
+        ]
+      }
+    }
+  }
+}

package/test-fixtures/protobufs/cloud_replay.proto

@@ -0,0 +1,82 @@
+// Copyright 2026 LiveKit, Inc.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+syntax = "proto3";
+
+package livekit;
+
+option go_package = "github.com/livekit/protocol/livekit";
+option csharp_namespace = "LiveKit.Proto";
+option ruby_package = "LiveKit::Proto";
+
+import "google/protobuf/empty.proto";
+import "livekit_egress.proto";
+import "livekit_models.proto";
+import "logger/options.proto";
+
+service Replay {
+  // List replays
+  rpc ListReplays(ListReplaysRequest) returns (ListReplaysResponse);
+
+  // Playback controls
+  rpc Playback(PlaybackRequest) returns (PlaybackResponse);
+  rpc Seek(SeekRequest) returns (google.protobuf.Empty);
+  rpc Close(ClosePlaybackRequest) returns (google.protobuf.Empty);
+
+  // Export a stored replay using egress
+  rpc Export(ExportReplayRequest) returns (EgressInfo);
+
+  // Delete all stored data
+  rpc DeleteReplay(DeleteReplayRequest) returns (google.protobuf.Empty);
+}
+
+message ListReplaysRequest {
+  string room_name = 1; // optional
+  livekit.TokenPagination page_token = 2;
+}
+
+message ListReplaysResponse {
+  repeated ReplayInfo replays = 1;
+  livekit.TokenPagination next_page_token = 2;
+}
+
+message ReplayInfo {
+  string replay_id = 1 [(logger.name) = "replayID"];
+  string room_name = 2;
+  int64 start_time = 3;
+  int64 duration_ms = 4;
+}
+
+message PlaybackRequest {
+  string replay_id = 1 [(logger.name) = "replayID"];
+  string playback_room = 2; // name of room to play into
+  int64 seek_offset_ms = 3; // initial timestamp (ms)
+}
+
+message PlaybackResponse {
+  string playback_id = 1 [(logger.name) = "playbackID"];
+}
+
+message SeekRequest {
+  string playback_id = 1 [(logger.name) = "playbackID"];
+  int64 seek_offset_ms = 2; // timestamp (ms)
+}
+
+message ClosePlaybackRequest {
+  string playback_id = 1 [(logger.name) = "playbackID"];
+}
+
+message DeleteReplayRequest {
+  string replay_id = 1 [(logger.name) = "replayID"];
+}

package/test-fixtures/protobufs/livekit_agent.proto

@@ -0,0 +1,185 @@
+// Copyright 2023 LiveKit, Inc.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//   http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+syntax = "proto3";
+
+package livekit;
+option go_package = "github.com/livekit/protocol/livekit";
+option csharp_namespace = "LiveKit.Proto";
+option ruby_package = "LiveKit::Proto";
+
+import "livekit_models.proto";
+import "logger/options.proto";
+
+message Job {
+  string id = 1;
+  string dispatch_id = 9 [(logger.name) = "dispatchID"];
+  JobType type = 2;
+  Room room = 3;
+  optional ParticipantInfo participant = 4;
+  string namespace = 5 [deprecated = true];
+  string metadata = 6 [(logger.sensitivity) = SENSITIVITY_PII];
+  string agent_name = 7;
+  JobState state = 8;
+  bool enable_recording = 10;
+  string deployment = 11;
+  map<string, string> attributes = 12 [(logger.sensitivity) = SENSITIVITY_PII];
+  bool enable_redaction = 13;
+}
+
+message JobState {
+  JobStatus status = 1;
+  string error = 2;
+  int64 started_at = 3;
+  int64 ended_at = 4;
+  int64 updated_at = 5;
+  string participant_identity = 6;
+  string worker_id = 7 [(logger.name) = "workerID"];
+  string agent_id = 8 [(logger.name) = "agentID"];
+}
+
+// from Worker to Server
+message WorkerMessage {
+  oneof message {
+    // agent workers need to register themselves with the server first
+    RegisterWorkerRequest register = 1;
+    // worker confirms to server that it's available for a job, or declines it
+    AvailabilityResponse availability = 2;
+
+    // worker can update its status to the server, including taking itself out of the pool
+    UpdateWorkerStatus update_worker = 3;
+    // job can send status updates to the server, useful for tracking progress
+    UpdateJobStatus update_job = 4;
+
+    WorkerPing ping = 5;
+    SimulateJobRequest simulate_job = 6;
+    MigrateJobRequest migrate_job = 7;
+  };
+}
+
+// from Server to Worker
+message ServerMessage {
+  oneof message {
+    // server confirms the registration, from this moment on, the worker is considered active
+    RegisterWorkerResponse register = 1;
+    // server asks worker to confirm availability for a job
+    AvailabilityRequest availability = 2;
+    JobAssignment assignment = 3;
+    JobTermination termination = 5;
+    WorkerPong pong = 4;
+  }
+}
+
+enum JobType {
+  JT_ROOM = 0;
+  JT_PUBLISHER = 1;
+  JT_PARTICIPANT = 2;
+}
+
+enum WorkerStatus {
+  WS_AVAILABLE = 0;
+  WS_FULL = 1;
+}
+
+enum JobStatus {
+  JS_PENDING = 0;
+  JS_RUNNING = 1;
+  JS_SUCCESS = 2;
+  JS_FAILED = 3;
+}
+
+message SimulateJobRequest {
+  JobType type = 1;
+  Room room = 2;
+  ParticipantInfo participant = 3;
+}
+
+message WorkerPing {
+  int64 timestamp = 1;
+}
+
+message WorkerPong {
+  int64 last_timestamp = 1;
+  int64 timestamp = 2;
+}
+
+message RegisterWorkerRequest {
+  JobType type = 1;
+  string agent_name = 8;
+  // string worker_id = 2;
+  string version = 3;
+  // string name = 4 [deprecated = true];
+  uint32 ping_interval = 5;
+  optional string namespace = 6;
+  ParticipantPermission allowed_permissions = 7;
+  string deployment = 9;
+}
+
+message RegisterWorkerResponse {
+  string worker_id = 1 [(logger.name) = "workerID"];
+  ServerInfo server_info = 3;
+}
+
+message MigrateJobRequest {
+  // string job_id = 1 [deprecated = true];
+  repeated string job_ids = 2;
+}
+
+message AvailabilityRequest {
+  Job job = 1;
+
+  // True when the job was previously assigned to another worker but has been
+  // migrated due to different reasons (e.g. worker failure, job migration)
+  bool resuming = 2;
+}
+
+message AvailabilityResponse {
+  string job_id = 1 [(logger.name) = "jobID"];
+  bool available = 2;
+  bool supports_resume = 3;
+  bool terminate = 8;
+
+  string participant_name = 4;
+  string participant_identity = 5;
+  string participant_metadata = 6;
+  map<string, string> participant_attributes = 7;
+  // NEXT_ID: 9
+}
+
+message UpdateJobStatus {
+  string job_id = 1 [(logger.name) = "jobID"];
+
+  // The worker can indicate the job end by either specifying SUCCESS or FAILED
+  JobStatus status = 2;
+
+  // metadata shown on the dashboard, useful for debugging
+  string error = 3;
+}
+
+message UpdateWorkerStatus {
+  optional WorkerStatus status = 1;
+  // optional string metadata = 2 [deprecated=true];
+  float load = 3;
+  uint32 job_count = 4;
+}
+
+message JobAssignment {
+  Job job = 1;
+  optional string url = 2;
+  string token = 3;
+}
+
+message JobTermination {
+  string job_id = 1 [(logger.name) = "jobID"];
+}