@livekit/protocol 1.29.1 → 1.29.3

package/src/gen/livekit_internal_pb.js

@@ -0,0 +1,191 @@
+// 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.
+
+// @generated by protoc-gen-es v1.10.0 with parameter "target=dts+js"
+// @generated from file livekit_internal.proto (package livekit, syntax proto3)
+/* eslint-disable */
+// @ts-nocheck
+
+import { proto3 } from "@bufbuild/protobuf";
+import { ClientInfo, PlayoutDelay, ReconnectReason } from "./livekit_models_pb.js";
+import { CreateRoomRequest } from "./livekit_room_pb.js";
+import { AutoParticipantEgress, AutoTrackEgress } from "./livekit_egress_pb.js";
+import { RoomAgentDispatch } from "./livekit_agent_dispatch_pb.js";
+
+/**
+ * @generated from enum livekit.NodeType
+ */
+export const NodeType = /*@__PURE__*/ proto3.makeEnum(
+  "livekit.NodeType",
+  [
+    {no: 0, name: "SERVER"},
+    {no: 1, name: "CONTROLLER"},
+    {no: 2, name: "MEDIA"},
+    {no: 4, name: "TURN"},
+    {no: 5, name: "SWEEPER"},
+    {no: 6, name: "DIRECTOR"},
+  ],
+);
+
+/**
+ * @generated from enum livekit.NodeState
+ */
+export const NodeState = /*@__PURE__*/ proto3.makeEnum(
+  "livekit.NodeState",
+  [
+    {no: 0, name: "STARTING_UP"},
+    {no: 1, name: "SERVING"},
+    {no: 2, name: "SHUTTING_DOWN"},
+  ],
+);
+
+/**
+ * @generated from enum livekit.ICECandidateType
+ */
+export const ICECandidateType = /*@__PURE__*/ proto3.makeEnum(
+  "livekit.ICECandidateType",
+  [
+    {no: 0, name: "ICT_NONE"},
+    {no: 1, name: "ICT_TCP"},
+    {no: 2, name: "ICT_TLS"},
+  ],
+);
+
+/**
+ * @generated from message livekit.Node
+ */
+export const Node = /*@__PURE__*/ proto3.makeMessageType(
+  "livekit.Node",
+  () => [
+    { no: 1, name: "id", kind: "scalar", T: 9 /* ScalarType.STRING */ },
+    { no: 2, name: "ip", kind: "scalar", T: 9 /* ScalarType.STRING */ },
+    { no: 3, name: "num_cpus", kind: "scalar", T: 13 /* ScalarType.UINT32 */ },
+    { no: 4, name: "stats", kind: "message", T: NodeStats },
+    { no: 5, name: "type", kind: "enum", T: proto3.getEnumType(NodeType) },
+    { no: 6, name: "state", kind: "enum", T: proto3.getEnumType(NodeState) },
+    { no: 7, name: "region", kind: "scalar", T: 9 /* ScalarType.STRING */ },
+  ],
+);
+
+/**
+ * @generated from message livekit.NodeStats
+ */
+export const NodeStats = /*@__PURE__*/ proto3.makeMessageType(
+  "livekit.NodeStats",
+  () => [
+    { no: 1, name: "started_at", kind: "scalar", T: 3 /* ScalarType.INT64 */ },
+    { no: 2, name: "updated_at", kind: "scalar", T: 3 /* ScalarType.INT64 */ },
+    { no: 3, name: "num_rooms", kind: "scalar", T: 5 /* ScalarType.INT32 */ },
+    { no: 4, name: "num_clients", kind: "scalar", T: 5 /* ScalarType.INT32 */ },
+    { no: 5, name: "num_tracks_in", kind: "scalar", T: 5 /* ScalarType.INT32 */ },
+    { no: 6, name: "num_tracks_out", kind: "scalar", T: 5 /* ScalarType.INT32 */ },
+    { no: 36, name: "num_track_publish_attempts", kind: "scalar", T: 5 /* ScalarType.INT32 */ },
+    { no: 37, name: "track_publish_attempts_per_sec", kind: "scalar", T: 2 /* ScalarType.FLOAT */ },
+    { no: 38, name: "num_track_publish_success", kind: "scalar", T: 5 /* ScalarType.INT32 */ },
+    { no: 39, name: "track_publish_success_per_sec", kind: "scalar", T: 2 /* ScalarType.FLOAT */ },
+    { no: 40, name: "num_track_subscribe_attempts", kind: "scalar", T: 5 /* ScalarType.INT32 */ },
+    { no: 41, name: "track_subscribe_attempts_per_sec", kind: "scalar", T: 2 /* ScalarType.FLOAT */ },
+    { no: 42, name: "num_track_subscribe_success", kind: "scalar", T: 5 /* ScalarType.INT32 */ },
+    { no: 43, name: "track_subscribe_success_per_sec", kind: "scalar", T: 2 /* ScalarType.FLOAT */ },
+    { no: 7, name: "bytes_in", kind: "scalar", T: 4 /* ScalarType.UINT64 */ },
+    { no: 8, name: "bytes_out", kind: "scalar", T: 4 /* ScalarType.UINT64 */ },
+    { no: 9, name: "packets_in", kind: "scalar", T: 4 /* ScalarType.UINT64 */ },
+    { no: 10, name: "packets_out", kind: "scalar", T: 4 /* ScalarType.UINT64 */ },
+    { no: 11, name: "nack_total", kind: "scalar", T: 4 /* ScalarType.UINT64 */ },
+    { no: 12, name: "bytes_in_per_sec", kind: "scalar", T: 2 /* ScalarType.FLOAT */ },
+    { no: 13, name: "bytes_out_per_sec", kind: "scalar", T: 2 /* ScalarType.FLOAT */ },
+    { no: 14, name: "packets_in_per_sec", kind: "scalar", T: 2 /* ScalarType.FLOAT */ },
+    { no: 15, name: "packets_out_per_sec", kind: "scalar", T: 2 /* ScalarType.FLOAT */ },
+    { no: 16, name: "nack_per_sec", kind: "scalar", T: 2 /* ScalarType.FLOAT */ },
+    { no: 17, name: "num_cpus", kind: "scalar", T: 13 /* ScalarType.UINT32 */ },
+    { no: 18, name: "load_avg_last1min", kind: "scalar", T: 2 /* ScalarType.FLOAT */ },
+    { no: 19, name: "load_avg_last5min", kind: "scalar", T: 2 /* ScalarType.FLOAT */ },
+    { no: 20, name: "load_avg_last15min", kind: "scalar", T: 2 /* ScalarType.FLOAT */ },
+    { no: 21, name: "cpu_load", kind: "scalar", T: 2 /* ScalarType.FLOAT */ },
+    { no: 33, name: "memory_load", kind: "scalar", T: 2 /* ScalarType.FLOAT */ },
+    { no: 34, name: "memory_total", kind: "scalar", T: 4 /* ScalarType.UINT64 */ },
+    { no: 35, name: "memory_used", kind: "scalar", T: 4 /* ScalarType.UINT64 */ },
+    { no: 28, name: "sys_packets_out", kind: "scalar", T: 13 /* ScalarType.UINT32 */ },
+    { no: 29, name: "sys_packets_dropped", kind: "scalar", T: 13 /* ScalarType.UINT32 */ },
+    { no: 30, name: "sys_packets_out_per_sec", kind: "scalar", T: 2 /* ScalarType.FLOAT */ },
+    { no: 31, name: "sys_packets_dropped_per_sec", kind: "scalar", T: 2 /* ScalarType.FLOAT */ },
+    { no: 32, name: "sys_packets_dropped_pct_per_sec", kind: "scalar", T: 2 /* ScalarType.FLOAT */ },
+    { no: 22, name: "retransmit_bytes_out", kind: "scalar", T: 4 /* ScalarType.UINT64 */ },
+    { no: 23, name: "retransmit_packets_out", kind: "scalar", T: 4 /* ScalarType.UINT64 */ },
+    { no: 24, name: "retransmit_bytes_out_per_sec", kind: "scalar", T: 2 /* ScalarType.FLOAT */ },
+    { no: 25, name: "retransmit_packets_out_per_sec", kind: "scalar", T: 2 /* ScalarType.FLOAT */ },
+    { no: 26, name: "participant_signal_connected", kind: "scalar", T: 4 /* ScalarType.UINT64 */ },
+    { no: 27, name: "participant_signal_connected_per_sec", kind: "scalar", T: 2 /* ScalarType.FLOAT */ },
+    { no: 44, name: "participant_rtc_connected", kind: "scalar", T: 4 /* ScalarType.UINT64 */ },
+    { no: 45, name: "participant_rtc_connected_per_sec", kind: "scalar", T: 2 /* ScalarType.FLOAT */ },
+    { no: 46, name: "participant_rtc_init", kind: "scalar", T: 4 /* ScalarType.UINT64 */ },
+    { no: 47, name: "participant_rtc_init_per_sec", kind: "scalar", T: 2 /* ScalarType.FLOAT */ },
+    { no: 48, name: "forward_latency", kind: "scalar", T: 13 /* ScalarType.UINT32 */ },
+    { no: 49, name: "forward_jitter", kind: "scalar", T: 13 /* ScalarType.UINT32 */ },
+  ],
+);
+
+/**
+ * @generated from message livekit.StartSession
+ */
+export const StartSession = /*@__PURE__*/ proto3.makeMessageType(
+  "livekit.StartSession",
+  () => [
+    { no: 1, name: "room_name", kind: "scalar", T: 9 /* ScalarType.STRING */ },
+    { no: 2, name: "identity", kind: "scalar", T: 9 /* ScalarType.STRING */ },
+    { no: 3, name: "connection_id", kind: "scalar", T: 9 /* ScalarType.STRING */ },
+    { no: 4, name: "reconnect", kind: "scalar", T: 8 /* ScalarType.BOOL */ },
+    { no: 9, name: "auto_subscribe", kind: "scalar", T: 8 /* ScalarType.BOOL */ },
+    { no: 10, name: "hidden", kind: "scalar", T: 8 /* ScalarType.BOOL */ },
+    { no: 11, name: "client", kind: "message", T: ClientInfo },
+    { no: 12, name: "recorder", kind: "scalar", T: 8 /* ScalarType.BOOL */ },
+    { no: 13, name: "name", kind: "scalar", T: 9 /* ScalarType.STRING */ },
+    { no: 14, name: "grants_json", kind: "scalar", T: 9 /* ScalarType.STRING */ },
+    { no: 15, name: "adaptive_stream", kind: "scalar", T: 8 /* ScalarType.BOOL */ },
+    { no: 16, name: "participant_id", kind: "scalar", T: 9 /* ScalarType.STRING */ },
+    { no: 17, name: "reconnect_reason", kind: "enum", T: proto3.getEnumType(ReconnectReason) },
+    { no: 18, name: "subscriber_allow_pause", kind: "scalar", T: 8 /* ScalarType.BOOL */, opt: true },
+    { no: 19, name: "disable_ice_lite", kind: "scalar", T: 8 /* ScalarType.BOOL */ },
+    { no: 20, name: "create_room", kind: "message", T: CreateRoomRequest },
+  ],
+);
+
+/**
+ * room info that should not be returned to clients
+ *
+ * @generated from message livekit.RoomInternal
+ */
+export const RoomInternal = /*@__PURE__*/ proto3.makeMessageType(
+  "livekit.RoomInternal",
+  () => [
+    { no: 1, name: "track_egress", kind: "message", T: AutoTrackEgress },
+    { no: 2, name: "participant_egress", kind: "message", T: AutoParticipantEgress },
+    { no: 3, name: "playout_delay", kind: "message", T: PlayoutDelay },
+    { no: 5, name: "agent_dispatches", kind: "message", T: RoomAgentDispatch, repeated: true },
+    { no: 4, name: "sync_streams", kind: "scalar", T: 8 /* ScalarType.BOOL */ },
+    { no: 6, name: "replay_enabled", kind: "scalar", T: 8 /* ScalarType.BOOL */ },
+  ],
+);
+
+/**
+ * @generated from message livekit.ICEConfig
+ */
+export const ICEConfig = /*@__PURE__*/ proto3.makeMessageType(
+  "livekit.ICEConfig",
+  () => [
+    { no: 1, name: "preference_subscriber", kind: "enum", T: proto3.getEnumType(ICECandidateType) },
+    { no: 2, name: "preference_publisher", kind: "enum", T: proto3.getEnumType(ICECandidateType) },
+  ],
+);
+

package/src/gen/livekit_metrics_pb.d.ts

@@ -0,0 +1,376 @@
+// @generated by protoc-gen-es v1.10.0 with parameter "target=dts+js"
+// @generated from file livekit_metrics.proto (package livekit, syntax proto3)
+/* eslint-disable */
+// @ts-nocheck
+
+import type { BinaryReadOptions, FieldList, JsonReadOptions, JsonValue, PartialMessage, PlainMessage, Timestamp } from "@bufbuild/protobuf";
+import { Message, proto3 } from "@bufbuild/protobuf";
+
+/**
+ * index from [0: MAX_LABEL_PREDEFINED_MAX_VALUE) are for predefined labels (`MetricLabel`)
+ *
+ * @generated from enum livekit.MetricLabel
+ */
+export declare enum MetricLabel {
+  /**
+   * time to first token from LLM
+   *
+   * @generated from enum value: AGENTS_LLM_TTFT = 0;
+   */
+  AGENTS_LLM_TTFT = 0,
+
+  /**
+   * time to final transcription
+   *
+   * @generated from enum value: AGENTS_STT_TTFT = 1;
+   */
+  AGENTS_STT_TTFT = 1,
+
+  /**
+   * time to first byte
+   *
+   * @generated from enum value: AGENTS_TTS_TTFB = 2;
+   */
+  AGENTS_TTS_TTFB = 2,
+
+  /**
+   * Number of video freezes
+   *
+   * @generated from enum value: CLIENT_VIDEO_SUBSCRIBER_FREEZE_COUNT = 3;
+   */
+  CLIENT_VIDEO_SUBSCRIBER_FREEZE_COUNT = 3,
+
+  /**
+   * total duration of freezes
+   *
+   * @generated from enum value: CLIENT_VIDEO_SUBSCRIBER_TOTAL_FREEZE_DURATION = 4;
+   */
+  CLIENT_VIDEO_SUBSCRIBER_TOTAL_FREEZE_DURATION = 4,
+
+  /**
+   * number of video pauses
+   *
+   * @generated from enum value: CLIENT_VIDEO_SUBSCRIBER_PAUSE_COUNT = 5;
+   */
+  CLIENT_VIDEO_SUBSCRIBER_PAUSE_COUNT = 5,
+
+  /**
+   * total duration of pauses
+   *
+   * @generated from enum value: CLIENT_VIDEO_SUBSCRIBER_TOTAL_PAUSES_DURATION = 6;
+   */
+  CLIENT_VIDEO_SUBSCRIBER_TOTAL_PAUSES_DURATION = 6,
+
+  /**
+   * number of concealed (synthesized) audio samples
+   *
+   * @generated from enum value: CLIENT_AUDIO_SUBSCRIBER_CONCEALED_SAMPLES = 7;
+   */
+  CLIENT_AUDIO_SUBSCRIBER_CONCEALED_SAMPLES = 7,
+
+  /**
+   * number of silent concealed samples
+   *
+   * @generated from enum value: CLIENT_AUDIO_SUBSCRIBER_SILENT_CONCEALED_SAMPLES = 8;
+   */
+  CLIENT_AUDIO_SUBSCRIBER_SILENT_CONCEALED_SAMPLES = 8,
+
+  /**
+   * number of concealment events
+   *
+   * @generated from enum value: CLIENT_AUDIO_SUBSCRIBER_CONCEALMENT_EVENTS = 9;
+   */
+  CLIENT_AUDIO_SUBSCRIBER_CONCEALMENT_EVENTS = 9,
+
+  /**
+   * number of interruptions
+   *
+   * @generated from enum value: CLIENT_AUDIO_SUBSCRIBER_INTERRUPTION_COUNT = 10;
+   */
+  CLIENT_AUDIO_SUBSCRIBER_INTERRUPTION_COUNT = 10,
+
+  /**
+   * total duration of interruptions
+   *
+   * @generated from enum value: CLIENT_AUDIO_SUBSCRIBER_TOTAL_INTERRUPTION_DURATION = 11;
+   */
+  CLIENT_AUDIO_SUBSCRIBER_TOTAL_INTERRUPTION_DURATION = 11,
+
+  /**
+   * total time spent in jitter buffer
+   *
+   * @generated from enum value: CLIENT_SUBSCRIBER_JITTER_BUFFER_DELAY = 12;
+   */
+  CLIENT_SUBSCRIBER_JITTER_BUFFER_DELAY = 12,
+
+  /**
+   * total time spent in jitter buffer
+   *
+   * @generated from enum value: CLIENT_SUBSCRIBER_JITTER_BUFFER_EMITTED_COUNT = 13;
+   */
+  CLIENT_SUBSCRIBER_JITTER_BUFFER_EMITTED_COUNT = 13,
+
+  /**
+   * total duration spent in bandwidth quality limitation
+   *
+   * @generated from enum value: CLIENT_VIDEO_PUBLISHER_QUALITY_LIMITATION_DURATION_BANDWIDTH = 14;
+   */
+  CLIENT_VIDEO_PUBLISHER_QUALITY_LIMITATION_DURATION_BANDWIDTH = 14,
+
+  /**
+   * total duration spent in cpu quality limitation
+   *
+   * @generated from enum value: CLIENT_VIDEO_PUBLISHER_QUALITY_LIMITATION_DURATION_CPU = 15;
+   */
+  CLIENT_VIDEO_PUBLISHER_QUALITY_LIMITATION_DURATION_CPU = 15,
+
+  /**
+   * total duration spent in other quality limitation
+   *
+   * @generated from enum value: CLIENT_VIDEO_PUBLISHER_QUALITY_LIMITATION_DURATION_OTHER = 16;
+   */
+  CLIENT_VIDEO_PUBLISHER_QUALITY_LIMITATION_DURATION_OTHER = 16,
+
+  /**
+   * Publisher RTT (participant -> server)
+   *
+   * @generated from enum value: PUBLISHER_RTT = 17;
+   */
+  PUBLISHER_RTT = 17,
+
+  /**
+   * RTT between publisher node and subscriber node (could involve intermedia node(s))
+   *
+   * @generated from enum value: SERVER_MESH_RTT = 18;
+   */
+  SERVER_MESH_RTT = 18,
+
+  /**
+   * Subscribe RTT (server -> participant)
+   *
+   * @generated from enum value: SUBSCRIBER_RTT = 19;
+   */
+  SUBSCRIBER_RTT = 19,
+
+  /**
+   * @generated from enum value: METRIC_LABEL_PREDEFINED_MAX_VALUE = 4096;
+   */
+  METRIC_LABEL_PREDEFINED_MAX_VALUE = 4096,
+}
+
+/**
+ * @generated from message livekit.MetricsBatch
+ */
+export declare class MetricsBatch extends Message<MetricsBatch> {
+  /**
+   * time at which this batch is sent based on a monotonic clock (millisecond resolution)
+   *
+   * @generated from field: int64 timestamp_ms = 1;
+   */
+  timestampMs: bigint;
+
+  /**
+   * @generated from field: google.protobuf.Timestamp normalized_timestamp = 2;
+   */
+  normalizedTimestamp?: Timestamp;
+
+  /**
+   * To avoid repeating string values, we store them in a separate list and reference them by index
+   * This is useful for storing participant identities, track names, etc.
+   * There is also a predefined list of labels that can be used to reference common metrics.
+   * They have reserved indices from 0 to (METRIC_LABEL_PREDEFINED_MAX_VALUE - 1).
+   * Indexes pointing at str_data should start from METRIC_LABEL_PREDEFINED_MAX_VALUE, 
+   * such that str_data[0] == index of METRIC_LABEL_PREDEFINED_MAX_VALUE.
+   *
+   * @generated from field: repeated string str_data = 3;
+   */
+  strData: string[];
+
+  /**
+   * @generated from field: repeated livekit.TimeSeriesMetric time_series = 4;
+   */
+  timeSeries: TimeSeriesMetric[];
+
+  /**
+   * @generated from field: repeated livekit.EventMetric events = 5;
+   */
+  events: EventMetric[];
+
+  constructor(data?: PartialMessage<MetricsBatch>);
+
+  static readonly runtime: typeof proto3;
+  static readonly typeName = "livekit.MetricsBatch";
+  static readonly fields: FieldList;
+
+  static fromBinary(bytes: Uint8Array, options?: Partial<BinaryReadOptions>): MetricsBatch;
+
+  static fromJson(jsonValue: JsonValue, options?: Partial<JsonReadOptions>): MetricsBatch;
+
+  static fromJsonString(jsonString: string, options?: Partial<JsonReadOptions>): MetricsBatch;
+
+  static equals(a: MetricsBatch | PlainMessage<MetricsBatch> | undefined, b: MetricsBatch | PlainMessage<MetricsBatch> | undefined): boolean;
+}
+
+/**
+ * @generated from message livekit.TimeSeriesMetric
+ */
+export declare class TimeSeriesMetric extends Message<TimeSeriesMetric> {
+  /**
+   * Metric name e.g "speech_probablity". The string value is not directly stored in the message, but referenced by index
+   * in the `str_data` field of `MetricsBatch`
+   *
+   * @generated from field: uint32 label = 1;
+   */
+  label: number;
+
+  /**
+   * index into `str_data`
+   *
+   * @generated from field: uint32 participant_identity = 2;
+   */
+  participantIdentity: number;
+
+  /**
+   * index into `str_data`
+   *
+   * @generated from field: uint32 track_sid = 3;
+   */
+  trackSid: number;
+
+  /**
+   * @generated from field: repeated livekit.MetricSample samples = 4;
+   */
+  samples: MetricSample[];
+
+  /**
+   * index into 'str_data'
+   *
+   * @generated from field: uint32 rid = 5;
+   */
+  rid: number;
+
+  constructor(data?: PartialMessage<TimeSeriesMetric>);
+
+  static readonly runtime: typeof proto3;
+  static readonly typeName = "livekit.TimeSeriesMetric";
+  static readonly fields: FieldList;
+
+  static fromBinary(bytes: Uint8Array, options?: Partial<BinaryReadOptions>): TimeSeriesMetric;
+
+  static fromJson(jsonValue: JsonValue, options?: Partial<JsonReadOptions>): TimeSeriesMetric;
+
+  static fromJsonString(jsonString: string, options?: Partial<JsonReadOptions>): TimeSeriesMetric;
+
+  static equals(a: TimeSeriesMetric | PlainMessage<TimeSeriesMetric> | undefined, b: TimeSeriesMetric | PlainMessage<TimeSeriesMetric> | undefined): boolean;
+}
+
+/**
+ * @generated from message livekit.MetricSample
+ */
+export declare class MetricSample extends Message<MetricSample> {
+  /**
+   * time of metric based on a monotonic clock (in milliseconds)
+   *
+   * @generated from field: int64 timestamp_ms = 1;
+   */
+  timestampMs: bigint;
+
+  /**
+   * @generated from field: google.protobuf.Timestamp normalized_timestamp = 2;
+   */
+  normalizedTimestamp?: Timestamp;
+
+  /**
+   * @generated from field: float value = 3;
+   */
+  value: number;
+
+  constructor(data?: PartialMessage<MetricSample>);
+
+  static readonly runtime: typeof proto3;
+  static readonly typeName = "livekit.MetricSample";
+  static readonly fields: FieldList;
+
+  static fromBinary(bytes: Uint8Array, options?: Partial<BinaryReadOptions>): MetricSample;
+
+  static fromJson(jsonValue: JsonValue, options?: Partial<JsonReadOptions>): MetricSample;
+
+  static fromJsonString(jsonString: string, options?: Partial<JsonReadOptions>): MetricSample;
+
+  static equals(a: MetricSample | PlainMessage<MetricSample> | undefined, b: MetricSample | PlainMessage<MetricSample> | undefined): boolean;
+}
+
+/**
+ * @generated from message livekit.EventMetric
+ */
+export declare class EventMetric extends Message<EventMetric> {
+  /**
+   * @generated from field: uint32 label = 1;
+   */
+  label: number;
+
+  /**
+   * index into `str_data`
+   *
+   * @generated from field: uint32 participant_identity = 2;
+   */
+  participantIdentity: number;
+
+  /**
+   * index into `str_data`
+   *
+   * @generated from field: uint32 track_sid = 3;
+   */
+  trackSid: number;
+
+  /**
+   * start time of event based on a monotonic clock (in milliseconds)
+   *
+   * @generated from field: int64 start_timestamp_ms = 4;
+   */
+  startTimestampMs: bigint;
+
+  /**
+   * end time of event based on a monotonic clock (in milliseconds), if needed
+   *
+   * @generated from field: optional int64 end_timestamp_ms = 5;
+   */
+  endTimestampMs?: bigint;
+
+  /**
+   * @generated from field: google.protobuf.Timestamp normalized_start_timestamp = 6;
+   */
+  normalizedStartTimestamp?: Timestamp;
+
+  /**
+   * @generated from field: optional google.protobuf.Timestamp normalized_end_timestamp = 7;
+   */
+  normalizedEndTimestamp?: Timestamp;
+
+  /**
+   * @generated from field: string metadata = 8;
+   */
+  metadata: string;
+
+  /**
+   * index into 'str_data'
+   *
+   * @generated from field: uint32 rid = 9;
+   */
+  rid: number;
+
+  constructor(data?: PartialMessage<EventMetric>);
+
+  static readonly runtime: typeof proto3;
+  static readonly typeName = "livekit.EventMetric";
+  static readonly fields: FieldList;
+
+  static fromBinary(bytes: Uint8Array, options?: Partial<BinaryReadOptions>): EventMetric;
+
+  static fromJson(jsonValue: JsonValue, options?: Partial<JsonReadOptions>): EventMetric;
+
+  static fromJsonString(jsonString: string, options?: Partial<JsonReadOptions>): EventMetric;
+
+  static equals(a: EventMetric | PlainMessage<EventMetric> | undefined, b: EventMetric | PlainMessage<EventMetric> | undefined): boolean;
+}
+

package/src/gen/livekit_metrics_pb.js

@@ -0,0 +1,97 @@
+// @generated by protoc-gen-es v1.10.0 with parameter "target=dts+js"
+// @generated from file livekit_metrics.proto (package livekit, syntax proto3)
+/* eslint-disable */
+// @ts-nocheck
+
+import { proto3, Timestamp } from "@bufbuild/protobuf";
+
+/**
+ * index from [0: MAX_LABEL_PREDEFINED_MAX_VALUE) are for predefined labels (`MetricLabel`)
+ *
+ * @generated from enum livekit.MetricLabel
+ */
+export const MetricLabel = /*@__PURE__*/ proto3.makeEnum(
+  "livekit.MetricLabel",
+  [
+    {no: 0, name: "AGENTS_LLM_TTFT"},
+    {no: 1, name: "AGENTS_STT_TTFT"},
+    {no: 2, name: "AGENTS_TTS_TTFB"},
+    {no: 3, name: "CLIENT_VIDEO_SUBSCRIBER_FREEZE_COUNT"},
+    {no: 4, name: "CLIENT_VIDEO_SUBSCRIBER_TOTAL_FREEZE_DURATION"},
+    {no: 5, name: "CLIENT_VIDEO_SUBSCRIBER_PAUSE_COUNT"},
+    {no: 6, name: "CLIENT_VIDEO_SUBSCRIBER_TOTAL_PAUSES_DURATION"},
+    {no: 7, name: "CLIENT_AUDIO_SUBSCRIBER_CONCEALED_SAMPLES"},
+    {no: 8, name: "CLIENT_AUDIO_SUBSCRIBER_SILENT_CONCEALED_SAMPLES"},
+    {no: 9, name: "CLIENT_AUDIO_SUBSCRIBER_CONCEALMENT_EVENTS"},
+    {no: 10, name: "CLIENT_AUDIO_SUBSCRIBER_INTERRUPTION_COUNT"},
+    {no: 11, name: "CLIENT_AUDIO_SUBSCRIBER_TOTAL_INTERRUPTION_DURATION"},
+    {no: 12, name: "CLIENT_SUBSCRIBER_JITTER_BUFFER_DELAY"},
+    {no: 13, name: "CLIENT_SUBSCRIBER_JITTER_BUFFER_EMITTED_COUNT"},
+    {no: 14, name: "CLIENT_VIDEO_PUBLISHER_QUALITY_LIMITATION_DURATION_BANDWIDTH"},
+    {no: 15, name: "CLIENT_VIDEO_PUBLISHER_QUALITY_LIMITATION_DURATION_CPU"},
+    {no: 16, name: "CLIENT_VIDEO_PUBLISHER_QUALITY_LIMITATION_DURATION_OTHER"},
+    {no: 17, name: "PUBLISHER_RTT"},
+    {no: 18, name: "SERVER_MESH_RTT"},
+    {no: 19, name: "SUBSCRIBER_RTT"},
+    {no: 4096, name: "METRIC_LABEL_PREDEFINED_MAX_VALUE"},
+  ],
+);
+
+/**
+ * @generated from message livekit.MetricsBatch
+ */
+export const MetricsBatch = /*@__PURE__*/ proto3.makeMessageType(
+  "livekit.MetricsBatch",
+  () => [
+    { no: 1, name: "timestamp_ms", kind: "scalar", T: 3 /* ScalarType.INT64 */ },
+    { no: 2, name: "normalized_timestamp", kind: "message", T: Timestamp },
+    { no: 3, name: "str_data", kind: "scalar", T: 9 /* ScalarType.STRING */, repeated: true },
+    { no: 4, name: "time_series", kind: "message", T: TimeSeriesMetric, repeated: true },
+    { no: 5, name: "events", kind: "message", T: EventMetric, repeated: true },
+  ],
+);
+
+/**
+ * @generated from message livekit.TimeSeriesMetric
+ */
+export const TimeSeriesMetric = /*@__PURE__*/ proto3.makeMessageType(
+  "livekit.TimeSeriesMetric",
+  () => [
+    { no: 1, name: "label", kind: "scalar", T: 13 /* ScalarType.UINT32 */ },
+    { no: 2, name: "participant_identity", kind: "scalar", T: 13 /* ScalarType.UINT32 */ },
+    { no: 3, name: "track_sid", kind: "scalar", T: 13 /* ScalarType.UINT32 */ },
+    { no: 4, name: "samples", kind: "message", T: MetricSample, repeated: true },
+    { no: 5, name: "rid", kind: "scalar", T: 13 /* ScalarType.UINT32 */ },
+  ],
+);
+
+/**
+ * @generated from message livekit.MetricSample
+ */
+export const MetricSample = /*@__PURE__*/ proto3.makeMessageType(
+  "livekit.MetricSample",
+  () => [
+    { no: 1, name: "timestamp_ms", kind: "scalar", T: 3 /* ScalarType.INT64 */ },
+    { no: 2, name: "normalized_timestamp", kind: "message", T: Timestamp },
+    { no: 3, name: "value", kind: "scalar", T: 2 /* ScalarType.FLOAT */ },
+  ],
+);
+
+/**
+ * @generated from message livekit.EventMetric
+ */
+export const EventMetric = /*@__PURE__*/ proto3.makeMessageType(
+  "livekit.EventMetric",
+  () => [
+    { no: 1, name: "label", kind: "scalar", T: 13 /* ScalarType.UINT32 */ },
+    { no: 2, name: "participant_identity", kind: "scalar", T: 13 /* ScalarType.UINT32 */ },
+    { no: 3, name: "track_sid", kind: "scalar", T: 13 /* ScalarType.UINT32 */ },
+    { no: 4, name: "start_timestamp_ms", kind: "scalar", T: 3 /* ScalarType.INT64 */ },
+    { no: 5, name: "end_timestamp_ms", kind: "scalar", T: 3 /* ScalarType.INT64 */, opt: true },
+    { no: 6, name: "normalized_start_timestamp", kind: "message", T: Timestamp },
+    { no: 7, name: "normalized_end_timestamp", kind: "message", T: Timestamp, opt: true },
+    { no: 8, name: "metadata", kind: "scalar", T: 9 /* ScalarType.STRING */ },
+    { no: 9, name: "rid", kind: "scalar", T: 13 /* ScalarType.UINT32 */ },
+  ],
+);
+