@livekit/agents 0.7.8 → 1.0.0-next.0

package/dist/metrics/usage_collector.js

@@ -1,26 +1,31 @@
-import { isLLMMetrics, isSTTMetrics, isTTSMetrics } from "./utils.js";
 class UsageCollector {
-  #summary;
+  summary;
   constructor() {
-    this.#summary = {
+    this.summary = {
       llmPromptTokens: 0,
+      llmPromptCachedTokens: 0,
       llmCompletionTokens: 0,
       ttsCharactersCount: 0,
       sttAudioDuration: 0
     };
   }
   collect(metrics) {
-    if (isLLMMetrics(metrics)) {
-      this.#summary.llmPromptTokens += metrics.promptTokens;
-      this.#summary.llmCompletionTokens += metrics.completionTokens;
-    } else if (isTTSMetrics(metrics)) {
-      this.#summary.ttsCharactersCount += metrics.charactersCount;
-    } else if (isSTTMetrics(metrics)) {
-      this.#summary.sttAudioDuration += metrics.audioDuration;
+    if (metrics.type === "llm_metrics") {
+      this.summary.llmPromptTokens += metrics.promptTokens;
+      this.summary.llmPromptCachedTokens += metrics.promptCachedTokens;
+      this.summary.llmCompletionTokens += metrics.completionTokens;
+    } else if (metrics.type === "realtime_model_metrics") {
+      this.summary.llmPromptTokens += metrics.inputTokens;
+      this.summary.llmPromptCachedTokens += metrics.inputTokenDetails.cachedTokens;
+      this.summary.llmCompletionTokens += metrics.outputTokens;
+    } else if (metrics.type === "tts_metrics") {
+      this.summary.ttsCharactersCount += metrics.charactersCount;
+    } else if (metrics.type === "stt_metrics") {
+      this.summary.sttAudioDuration += metrics.audioDuration;
     }
   }
-  get summary() {
-    return { ...this.#summary };
+  getSummary() {
+    return { ...this.summary };
   }
 }
 export {

package/dist/metrics/usage_collector.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/metrics/usage_collector.ts"],"sourcesContent":["// SPDX-FileCopyrightText: 2024 LiveKit, Inc.\n//\n// SPDX-License-Identifier: Apache-2.0\nimport type { AgentMetrics } from './base.js';\nimport { isLLMMetrics, isSTTMetrics, isTTSMetrics } from './utils.js';\n\nexport interface UsageSummary {\n  llmPromptTokens: number;\n  llmCompletionTokens: number;\n  ttsCharactersCount: number;\n  sttAudioDuration: number;\n}\n\nexport class UsageCollector {\n  #summary: UsageSummary;\n\n  constructor() {\n    this.#summary = {\n      llmPromptTokens: 0,\n      llmCompletionTokens: 0,\n      ttsCharactersCount: 0,\n      sttAudioDuration: 0,\n    };\n  }\n\n  collect(metrics: AgentMetrics) {\n    if (isLLMMetrics(metrics)) {\n      this.#summary.llmPromptTokens += metrics.promptTokens;\n      this.#summary.llmCompletionTokens += metrics.completionTokens;\n    } else if (isTTSMetrics(metrics)) {\n      this.#summary.ttsCharactersCount += metrics.charactersCount;\n    } else if (isSTTMetrics(metrics)) {\n      this.#summary.sttAudioDuration += metrics.audioDuration;\n    }\n  }\n\n  get summary(): UsageSummary {\n    return { ...this.#summary };\n  }\n}\n"],"mappings":"AAIA,SAAS,cAAc,cAAc,oBAAoB;AASlD,MAAM,eAAe;AAAA,EAC1B;AAAA,EAEA,cAAc;AACZ,SAAK,WAAW;AAAA,MACd,iBAAiB;AAAA,MACjB,qBAAqB;AAAA,MACrB,oBAAoB;AAAA,MACpB,kBAAkB;AAAA,IACpB;AAAA,EACF;AAAA,EAEA,QAAQ,SAAuB;AAC7B,QAAI,aAAa,OAAO,GAAG;AACzB,WAAK,SAAS,mBAAmB,QAAQ;AACzC,WAAK,SAAS,uBAAuB,QAAQ;AAAA,IAC/C,WAAW,aAAa,OAAO,GAAG;AAChC,WAAK,SAAS,sBAAsB,QAAQ;AAAA,IAC9C,WAAW,aAAa,OAAO,GAAG;AAChC,WAAK,SAAS,oBAAoB,QAAQ;AAAA,IAC5C;AAAA,EACF;AAAA,EAEA,IAAI,UAAwB;AAC1B,WAAO,EAAE,GAAG,KAAK,SAAS;AAAA,EAC5B;AACF;","names":[]}
+{"version":3,"sources":["../../src/metrics/usage_collector.ts"],"sourcesContent":["// SPDX-FileCopyrightText: 2024 LiveKit, Inc.\n//\n// SPDX-License-Identifier: Apache-2.0\nimport type { AgentMetrics } from './base.js';\n\nexport interface UsageSummary {\n  llmPromptTokens: number;\n  llmPromptCachedTokens: number;\n  llmCompletionTokens: number;\n  ttsCharactersCount: number;\n  sttAudioDuration: number;\n}\n\nexport class UsageCollector {\n  private summary: UsageSummary;\n\n  constructor() {\n    this.summary = {\n      llmPromptTokens: 0,\n      llmPromptCachedTokens: 0,\n      llmCompletionTokens: 0,\n      ttsCharactersCount: 0,\n      sttAudioDuration: 0,\n    };\n  }\n\n  collect(metrics: AgentMetrics): void {\n    if (metrics.type === 'llm_metrics') {\n      this.summary.llmPromptTokens += metrics.promptTokens;\n      this.summary.llmPromptCachedTokens += metrics.promptCachedTokens;\n      this.summary.llmCompletionTokens += metrics.completionTokens;\n    } else if (metrics.type === 'realtime_model_metrics') {\n      this.summary.llmPromptTokens += metrics.inputTokens;\n      this.summary.llmPromptCachedTokens += metrics.inputTokenDetails.cachedTokens;\n      this.summary.llmCompletionTokens += metrics.outputTokens;\n    } else if (metrics.type === 'tts_metrics') {\n      this.summary.ttsCharactersCount += metrics.charactersCount;\n    } else if (metrics.type === 'stt_metrics') {\n      this.summary.sttAudioDuration += metrics.audioDuration;\n    }\n  }\n\n  getSummary(): UsageSummary {\n    return { ...this.summary };\n  }\n}\n"],"mappings":"AAaO,MAAM,eAAe;AAAA,EAClB;AAAA,EAER,cAAc;AACZ,SAAK,UAAU;AAAA,MACb,iBAAiB;AAAA,MACjB,uBAAuB;AAAA,MACvB,qBAAqB;AAAA,MACrB,oBAAoB;AAAA,MACpB,kBAAkB;AAAA,IACpB;AAAA,EACF;AAAA,EAEA,QAAQ,SAA6B;AACnC,QAAI,QAAQ,SAAS,eAAe;AAClC,WAAK,QAAQ,mBAAmB,QAAQ;AACxC,WAAK,QAAQ,yBAAyB,QAAQ;AAC9C,WAAK,QAAQ,uBAAuB,QAAQ;AAAA,IAC9C,WAAW,QAAQ,SAAS,0BAA0B;AACpD,WAAK,QAAQ,mBAAmB,QAAQ;AACxC,WAAK,QAAQ,yBAAyB,QAAQ,kBAAkB;AAChE,WAAK,QAAQ,uBAAuB,QAAQ;AAAA,IAC9C,WAAW,QAAQ,SAAS,eAAe;AACzC,WAAK,QAAQ,sBAAsB,QAAQ;AAAA,IAC7C,WAAW,QAAQ,SAAS,eAAe;AACzC,WAAK,QAAQ,oBAAoB,QAAQ;AAAA,IAC3C;AAAA,EACF;AAAA,EAEA,aAA2B;AACzB,WAAO,EAAE,GAAG,KAAK,QAAQ;AAAA,EAC3B;AACF;","names":[]}

package/dist/metrics/utils.cjs

@@ -18,87 +18,50 @@ var __copyProps = (to, from, except, desc) => {
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 var utils_exports = {};
 __export(utils_exports, {
-  isLLMMetrics: () => isLLMMetrics,
-  isPipelineEOUMetrics: () => isPipelineEOUMetrics,
-  isPipelineLLMMetrics: () => isPipelineLLMMetrics,
-  isPipelineTTSMetrics: () => isPipelineTTSMetrics,
-  isSTTMetrics: () => isSTTMetrics,
-  isTTSMetrics: () => isTTSMetrics,
-  isVADMetrics: () => isVADMetrics,
   logMetrics: () => logMetrics
 });
 module.exports = __toCommonJS(utils_exports);
 var import_log = require("../log.cjs");
+function roundTwoDecimals(value) {
+  return Math.round(value * 100) / 100;
+}
 const logMetrics = (metrics) => {
   const logger = (0, import_log.log)();
-  if (isPipelineLLMMetrics(metrics)) {
+  if (metrics.type === "llm_metrics") {
     logger.child({
-      sequenceId: metrics.sequenceId,
-      ttft: metrics.ttft,
+      ttft: roundTwoDecimals(metrics.ttft),
       inputTokens: metrics.promptTokens,
+      promptCachedTokens: metrics.promptCachedTokens,
       outputTokens: metrics.completionTokens,
-      tokensPerSecond: metrics.tokensPerSecond
-    }).info("Pipeline LLM metrics");
-  } else if (isLLMMetrics(metrics)) {
-    logger.child({
-      ttft: metrics.ttft,
-      inputTokens: metrics.promptTokens,
-      outputTokens: metrics.completionTokens,
-      tokensPerSecond: metrics.tokensPerSecond
+      tokensPerSecond: roundTwoDecimals(metrics.tokensPerSecond)
     }).info("LLM metrics");
-  } else if (isPipelineTTSMetrics(metrics)) {
+  } else if (metrics.type === "realtime_model_metrics") {
     logger.child({
-      sequenceId: metrics.sequenceId,
-      ttfb: metrics.ttfb,
-      audioDuration: metrics.audioDuration
-    }).info("Pipeline TTS metrics");
-  } else if (isTTSMetrics(metrics)) {
+      ttft: roundTwoDecimals(metrics.ttft),
+      input_tokens: metrics.inputTokens,
+      cached_input_tokens: metrics.inputTokenDetails.cachedTokens,
+      output_tokens: metrics.outputTokens,
+      total_tokens: metrics.totalTokens,
+      tokens_per_second: roundTwoDecimals(metrics.tokensPerSecond)
+    }).info("RealtimeModel metrics");
+  } else if (metrics.type === "tts_metrics") {
     logger.child({
-      ttfb: metrics.ttfb,
+      ttfb: roundTwoDecimals(metrics.ttfb),
       audioDuration: metrics.audioDuration
     }).info("TTS metrics");
-  } else if (isPipelineEOUMetrics(metrics)) {
+  } else if (metrics.type === "eou_metrics") {
     logger.child({
-      sequenceId: metrics.sequenceId,
-      endOfUtteranceDelay: metrics.endOfUtteranceDelay,
-      transcriptionDelay: metrics.transcriptionDelay
-    }).info("Pipeline EOU metrics");
-  } else if (isSTTMetrics(metrics)) {
+      end_of_utterance_delay: roundTwoDecimals(metrics.endOfUtteranceDelay),
+      transcription_delay: roundTwoDecimals(metrics.transcriptionDelay)
+    }).info("EOU metrics");
+  } else if (metrics.type === "stt_metrics") {
     logger.child({
       audioDuration: metrics.audioDuration
     }).info("STT metrics");
   }
 };
-const isLLMMetrics = (metrics) => {
-  return !!metrics.ttft;
-};
-const isPipelineLLMMetrics = (metrics) => {
-  return isLLMMetrics(metrics) && !!metrics.sequenceId;
-};
-const isVADMetrics = (metrics) => {
-  return !!metrics.inferenceCount;
-};
-const isPipelineEOUMetrics = (metrics) => {
-  return !!metrics.endOfUtteranceDelay;
-};
-const isTTSMetrics = (metrics) => {
-  return !!metrics.ttfb;
-};
-const isPipelineTTSMetrics = (metrics) => {
-  return isTTSMetrics(metrics) && !!metrics.sequenceId;
-};
-const isSTTMetrics = (metrics) => {
-  return !(isLLMMetrics(metrics) || isVADMetrics(metrics) || isPipelineEOUMetrics(metrics) || isTTSMetrics(metrics));
-};
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
-  isLLMMetrics,
-  isPipelineEOUMetrics,
-  isPipelineLLMMetrics,
-  isPipelineTTSMetrics,
-  isSTTMetrics,
-  isTTSMetrics,
-  isVADMetrics,
   logMetrics
 });
 //# sourceMappingURL=utils.cjs.map

package/dist/metrics/utils.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/metrics/utils.ts"],"sourcesContent":["// SPDX-FileCopyrightText: 2024 LiveKit, Inc.\n//\n// SPDX-License-Identifier: Apache-2.0\nimport { log } from '../log.js';\nimport type {\n  AgentMetrics,\n  LLMMetrics,\n  PipelineEOUMetrics,\n  PipelineLLMMetrics,\n  PipelineTTSMetrics,\n  STTMetrics,\n  TTSMetrics,\n  VADMetrics,\n} from './base.js';\n\nexport const logMetrics = (metrics: AgentMetrics) => {\n  const logger = log();\n  if (isPipelineLLMMetrics(metrics)) {\n    logger\n      .child({\n        sequenceId: metrics.sequenceId,\n        ttft: metrics.ttft,\n        inputTokens: metrics.promptTokens,\n        outputTokens: metrics.completionTokens,\n        tokensPerSecond: metrics.tokensPerSecond,\n      })\n      .info('Pipeline LLM metrics');\n  } else if (isLLMMetrics(metrics)) {\n    logger\n      .child({\n        ttft: metrics.ttft,\n        inputTokens: metrics.promptTokens,\n        outputTokens: metrics.completionTokens,\n        tokensPerSecond: metrics.tokensPerSecond,\n      })\n      .info('LLM metrics');\n  } else if (isPipelineTTSMetrics(metrics)) {\n    logger\n      .child({\n        sequenceId: metrics.sequenceId,\n        ttfb: metrics.ttfb,\n        audioDuration: metrics.audioDuration,\n      })\n      .info('Pipeline TTS metrics');\n  } else if (isTTSMetrics(metrics)) {\n    logger\n      .child({\n        ttfb: metrics.ttfb,\n        audioDuration: metrics.audioDuration,\n      })\n      .info('TTS metrics');\n  } else if (isPipelineEOUMetrics(metrics)) {\n    logger\n      .child({\n        sequenceId: metrics.sequenceId,\n        endOfUtteranceDelay: metrics.endOfUtteranceDelay,\n        transcriptionDelay: metrics.transcriptionDelay,\n      })\n      .info('Pipeline EOU metrics');\n  } else if (isSTTMetrics(metrics)) {\n    logger\n      .child({\n        audioDuration: metrics.audioDuration,\n      })\n      .info('STT metrics');\n  }\n};\n\nexport const isLLMMetrics = (metrics: AgentMetrics): metrics is LLMMetrics => {\n  return !!(metrics as LLMMetrics).ttft;\n};\n\nexport const isPipelineLLMMetrics = (metrics: AgentMetrics): metrics is PipelineLLMMetrics => {\n  return isLLMMetrics(metrics) && !!(metrics as PipelineLLMMetrics).sequenceId;\n};\n\nexport const isVADMetrics = (metrics: AgentMetrics): metrics is VADMetrics => {\n  return !!(metrics as VADMetrics).inferenceCount;\n};\n\nexport const isPipelineEOUMetrics = (metrics: AgentMetrics): metrics is PipelineEOUMetrics => {\n  return !!(metrics as PipelineEOUMetrics).endOfUtteranceDelay;\n};\n\nexport const isTTSMetrics = (metrics: AgentMetrics): metrics is TTSMetrics => {\n  return !!(metrics as TTSMetrics).ttfb;\n};\n\nexport const isPipelineTTSMetrics = (metrics: AgentMetrics): metrics is PipelineTTSMetrics => {\n  return isTTSMetrics(metrics) && !!(metrics as PipelineTTSMetrics).sequenceId;\n};\n\nexport const isSTTMetrics = (metrics: AgentMetrics): metrics is STTMetrics => {\n  return !(\n    isLLMMetrics(metrics) ||\n    isVADMetrics(metrics) ||\n    isPipelineEOUMetrics(metrics) ||\n    isTTSMetrics(metrics)\n  );\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAGA,iBAAoB;AAYb,MAAM,aAAa,CAAC,YAA0B;AACnD,QAAM,aAAS,gBAAI;AACnB,MAAI,qBAAqB,OAAO,GAAG;AACjC,WACG,MAAM;AAAA,MACL,YAAY,QAAQ;AAAA,MACpB,MAAM,QAAQ;AAAA,MACd,aAAa,QAAQ;AAAA,MACrB,cAAc,QAAQ;AAAA,MACtB,iBAAiB,QAAQ;AAAA,IAC3B,CAAC,EACA,KAAK,sBAAsB;AAAA,EAChC,WAAW,aAAa,OAAO,GAAG;AAChC,WACG,MAAM;AAAA,MACL,MAAM,QAAQ;AAAA,MACd,aAAa,QAAQ;AAAA,MACrB,cAAc,QAAQ;AAAA,MACtB,iBAAiB,QAAQ;AAAA,IAC3B,CAAC,EACA,KAAK,aAAa;AAAA,EACvB,WAAW,qBAAqB,OAAO,GAAG;AACxC,WACG,MAAM;AAAA,MACL,YAAY,QAAQ;AAAA,MACpB,MAAM,QAAQ;AAAA,MACd,eAAe,QAAQ;AAAA,IACzB,CAAC,EACA,KAAK,sBAAsB;AAAA,EAChC,WAAW,aAAa,OAAO,GAAG;AAChC,WACG,MAAM;AAAA,MACL,MAAM,QAAQ;AAAA,MACd,eAAe,QAAQ;AAAA,IACzB,CAAC,EACA,KAAK,aAAa;AAAA,EACvB,WAAW,qBAAqB,OAAO,GAAG;AACxC,WACG,MAAM;AAAA,MACL,YAAY,QAAQ;AAAA,MACpB,qBAAqB,QAAQ;AAAA,MAC7B,oBAAoB,QAAQ;AAAA,IAC9B,CAAC,EACA,KAAK,sBAAsB;AAAA,EAChC,WAAW,aAAa,OAAO,GAAG;AAChC,WACG,MAAM;AAAA,MACL,eAAe,QAAQ;AAAA,IACzB,CAAC,EACA,KAAK,aAAa;AAAA,EACvB;AACF;AAEO,MAAM,eAAe,CAAC,YAAiD;AAC5E,SAAO,CAAC,CAAE,QAAuB;AACnC;AAEO,MAAM,uBAAuB,CAAC,YAAyD;AAC5F,SAAO,aAAa,OAAO,KAAK,CAAC,CAAE,QAA+B;AACpE;AAEO,MAAM,eAAe,CAAC,YAAiD;AAC5E,SAAO,CAAC,CAAE,QAAuB;AACnC;AAEO,MAAM,uBAAuB,CAAC,YAAyD;AAC5F,SAAO,CAAC,CAAE,QAA+B;AAC3C;AAEO,MAAM,eAAe,CAAC,YAAiD;AAC5E,SAAO,CAAC,CAAE,QAAuB;AACnC;AAEO,MAAM,uBAAuB,CAAC,YAAyD;AAC5F,SAAO,aAAa,OAAO,KAAK,CAAC,CAAE,QAA+B;AACpE;AAEO,MAAM,eAAe,CAAC,YAAiD;AAC5E,SAAO,EACL,aAAa,OAAO,KACpB,aAAa,OAAO,KACpB,qBAAqB,OAAO,KAC5B,aAAa,OAAO;AAExB;","names":[]}
+{"version":3,"sources":["../../src/metrics/utils.ts"],"sourcesContent":["// SPDX-FileCopyrightText: 2024 LiveKit, Inc.\n//\n// SPDX-License-Identifier: Apache-2.0\nimport { log } from '../log.js';\nimport type { AgentMetrics } from './base.js';\n\nfunction roundTwoDecimals(value: number) {\n  return Math.round(value * 100) / 100;\n}\n\nexport const logMetrics = (metrics: AgentMetrics) => {\n  const logger = log();\n  if (metrics.type === 'llm_metrics') {\n    logger\n      .child({\n        ttft: roundTwoDecimals(metrics.ttft),\n        inputTokens: metrics.promptTokens,\n        promptCachedTokens: metrics.promptCachedTokens,\n        outputTokens: metrics.completionTokens,\n        tokensPerSecond: roundTwoDecimals(metrics.tokensPerSecond),\n      })\n      .info('LLM metrics');\n  } else if (metrics.type === 'realtime_model_metrics') {\n    logger\n      .child({\n        ttft: roundTwoDecimals(metrics.ttft),\n        input_tokens: metrics.inputTokens,\n        cached_input_tokens: metrics.inputTokenDetails.cachedTokens,\n        output_tokens: metrics.outputTokens,\n        total_tokens: metrics.totalTokens,\n        tokens_per_second: roundTwoDecimals(metrics.tokensPerSecond),\n      })\n      .info('RealtimeModel metrics');\n  } else if (metrics.type === 'tts_metrics') {\n    logger\n      .child({\n        ttfb: roundTwoDecimals(metrics.ttfb),\n        audioDuration: metrics.audioDuration,\n      })\n      .info('TTS metrics');\n  } else if (metrics.type === 'eou_metrics') {\n    logger\n      .child({\n        end_of_utterance_delay: roundTwoDecimals(metrics.endOfUtteranceDelay),\n        transcription_delay: roundTwoDecimals(metrics.transcriptionDelay),\n      })\n      .info('EOU metrics');\n  } else if (metrics.type === 'stt_metrics') {\n    logger\n      .child({\n        audioDuration: metrics.audioDuration,\n      })\n      .info('STT metrics');\n  }\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAGA,iBAAoB;AAGpB,SAAS,iBAAiB,OAAe;AACvC,SAAO,KAAK,MAAM,QAAQ,GAAG,IAAI;AACnC;AAEO,MAAM,aAAa,CAAC,YAA0B;AACnD,QAAM,aAAS,gBAAI;AACnB,MAAI,QAAQ,SAAS,eAAe;AAClC,WACG,MAAM;AAAA,MACL,MAAM,iBAAiB,QAAQ,IAAI;AAAA,MACnC,aAAa,QAAQ;AAAA,MACrB,oBAAoB,QAAQ;AAAA,MAC5B,cAAc,QAAQ;AAAA,MACtB,iBAAiB,iBAAiB,QAAQ,eAAe;AAAA,IAC3D,CAAC,EACA,KAAK,aAAa;AAAA,EACvB,WAAW,QAAQ,SAAS,0BAA0B;AACpD,WACG,MAAM;AAAA,MACL,MAAM,iBAAiB,QAAQ,IAAI;AAAA,MACnC,cAAc,QAAQ;AAAA,MACtB,qBAAqB,QAAQ,kBAAkB;AAAA,MAC/C,eAAe,QAAQ;AAAA,MACvB,cAAc,QAAQ;AAAA,MACtB,mBAAmB,iBAAiB,QAAQ,eAAe;AAAA,IAC7D,CAAC,EACA,KAAK,uBAAuB;AAAA,EACjC,WAAW,QAAQ,SAAS,eAAe;AACzC,WACG,MAAM;AAAA,MACL,MAAM,iBAAiB,QAAQ,IAAI;AAAA,MACnC,eAAe,QAAQ;AAAA,IACzB,CAAC,EACA,KAAK,aAAa;AAAA,EACvB,WAAW,QAAQ,SAAS,eAAe;AACzC,WACG,MAAM;AAAA,MACL,wBAAwB,iBAAiB,QAAQ,mBAAmB;AAAA,MACpE,qBAAqB,iBAAiB,QAAQ,kBAAkB;AAAA,IAClE,CAAC,EACA,KAAK,aAAa;AAAA,EACvB,WAAW,QAAQ,SAAS,eAAe;AACzC,WACG,MAAM;AAAA,MACL,eAAe,QAAQ;AAAA,IACzB,CAAC,EACA,KAAK,aAAa;AAAA,EACvB;AACF;","names":[]}

package/dist/metrics/utils.d.cts

@@ -1,10 +1,3 @@
-import type { AgentMetrics, LLMMetrics, PipelineEOUMetrics, PipelineLLMMetrics, PipelineTTSMetrics, STTMetrics, TTSMetrics, VADMetrics } from './base.js';
+import type { AgentMetrics } from './base.js';
 export declare const logMetrics: (metrics: AgentMetrics) => void;
-export declare const isLLMMetrics: (metrics: AgentMetrics) => metrics is LLMMetrics;
-export declare const isPipelineLLMMetrics: (metrics: AgentMetrics) => metrics is PipelineLLMMetrics;
-export declare const isVADMetrics: (metrics: AgentMetrics) => metrics is VADMetrics;
-export declare const isPipelineEOUMetrics: (metrics: AgentMetrics) => metrics is PipelineEOUMetrics;
-export declare const isTTSMetrics: (metrics: AgentMetrics) => metrics is TTSMetrics;
-export declare const isPipelineTTSMetrics: (metrics: AgentMetrics) => metrics is PipelineTTSMetrics;
-export declare const isSTTMetrics: (metrics: AgentMetrics) => metrics is STTMetrics;
 //# sourceMappingURL=utils.d.ts.map

package/dist/metrics/utils.d.ts

@@ -1,10 +1,3 @@
-import type { AgentMetrics, LLMMetrics, PipelineEOUMetrics, PipelineLLMMetrics, PipelineTTSMetrics, STTMetrics, TTSMetrics, VADMetrics } from './base.js';
+import type { AgentMetrics } from './base.js';
 export declare const logMetrics: (metrics: AgentMetrics) => void;
-export declare const isLLMMetrics: (metrics: AgentMetrics) => metrics is LLMMetrics;
-export declare const isPipelineLLMMetrics: (metrics: AgentMetrics) => metrics is PipelineLLMMetrics;
-export declare const isVADMetrics: (metrics: AgentMetrics) => metrics is VADMetrics;
-export declare const isPipelineEOUMetrics: (metrics: AgentMetrics) => metrics is PipelineEOUMetrics;
-export declare const isTTSMetrics: (metrics: AgentMetrics) => metrics is TTSMetrics;
-export declare const isPipelineTTSMetrics: (metrics: AgentMetrics) => metrics is PipelineTTSMetrics;
-export declare const isSTTMetrics: (metrics: AgentMetrics) => metrics is STTMetrics;
 //# sourceMappingURL=utils.d.ts.map

package/dist/metrics/utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/metrics/utils.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,YAAY,EACZ,UAAU,EACV,kBAAkB,EAClB,kBAAkB,EAClB,kBAAkB,EAClB,UAAU,EACV,UAAU,EACV,UAAU,EACX,MAAM,WAAW,CAAC;AAEnB,eAAO,MAAM,UAAU,YAAa,YAAY,SAmD/C,CAAC;AAEF,eAAO,MAAM,YAAY,YAAa,YAAY,0BAEjD,CAAC;AAEF,eAAO,MAAM,oBAAoB,YAAa,YAAY,kCAEzD,CAAC;AAEF,eAAO,MAAM,YAAY,YAAa,YAAY,0BAEjD,CAAC;AAEF,eAAO,MAAM,oBAAoB,YAAa,YAAY,kCAEzD,CAAC;AAEF,eAAO,MAAM,YAAY,YAAa,YAAY,0BAEjD,CAAC;AAEF,eAAO,MAAM,oBAAoB,YAAa,YAAY,kCAEzD,CAAC;AAEF,eAAO,MAAM,YAAY,YAAa,YAAY,0BAOjD,CAAC"}
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/metrics/utils.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAM9C,eAAO,MAAM,UAAU,YAAa,YAAY,SA4C/C,CAAC"}

package/dist/metrics/utils.js

@@ -1,73 +1,43 @@
 import { log } from "../log.js";
+function roundTwoDecimals(value) {
+  return Math.round(value * 100) / 100;
+}
 const logMetrics = (metrics) => {
   const logger = log();
-  if (isPipelineLLMMetrics(metrics)) {
+  if (metrics.type === "llm_metrics") {
     logger.child({
-      sequenceId: metrics.sequenceId,
-      ttft: metrics.ttft,
+      ttft: roundTwoDecimals(metrics.ttft),
       inputTokens: metrics.promptTokens,
+      promptCachedTokens: metrics.promptCachedTokens,
       outputTokens: metrics.completionTokens,
-      tokensPerSecond: metrics.tokensPerSecond
-    }).info("Pipeline LLM metrics");
-  } else if (isLLMMetrics(metrics)) {
-    logger.child({
-      ttft: metrics.ttft,
-      inputTokens: metrics.promptTokens,
-      outputTokens: metrics.completionTokens,
-      tokensPerSecond: metrics.tokensPerSecond
+      tokensPerSecond: roundTwoDecimals(metrics.tokensPerSecond)
     }).info("LLM metrics");
-  } else if (isPipelineTTSMetrics(metrics)) {
+  } else if (metrics.type === "realtime_model_metrics") {
     logger.child({
-      sequenceId: metrics.sequenceId,
-      ttfb: metrics.ttfb,
-      audioDuration: metrics.audioDuration
-    }).info("Pipeline TTS metrics");
-  } else if (isTTSMetrics(metrics)) {
+      ttft: roundTwoDecimals(metrics.ttft),
+      input_tokens: metrics.inputTokens,
+      cached_input_tokens: metrics.inputTokenDetails.cachedTokens,
+      output_tokens: metrics.outputTokens,
+      total_tokens: metrics.totalTokens,
+      tokens_per_second: roundTwoDecimals(metrics.tokensPerSecond)
+    }).info("RealtimeModel metrics");
+  } else if (metrics.type === "tts_metrics") {
     logger.child({
-      ttfb: metrics.ttfb,
+      ttfb: roundTwoDecimals(metrics.ttfb),
       audioDuration: metrics.audioDuration
     }).info("TTS metrics");
-  } else if (isPipelineEOUMetrics(metrics)) {
+  } else if (metrics.type === "eou_metrics") {
     logger.child({
-      sequenceId: metrics.sequenceId,
-      endOfUtteranceDelay: metrics.endOfUtteranceDelay,
-      transcriptionDelay: metrics.transcriptionDelay
-    }).info("Pipeline EOU metrics");
-  } else if (isSTTMetrics(metrics)) {
+      end_of_utterance_delay: roundTwoDecimals(metrics.endOfUtteranceDelay),
+      transcription_delay: roundTwoDecimals(metrics.transcriptionDelay)
+    }).info("EOU metrics");
+  } else if (metrics.type === "stt_metrics") {
     logger.child({
       audioDuration: metrics.audioDuration
     }).info("STT metrics");
   }
 };
-const isLLMMetrics = (metrics) => {
-  return !!metrics.ttft;
-};
-const isPipelineLLMMetrics = (metrics) => {
-  return isLLMMetrics(metrics) && !!metrics.sequenceId;
-};
-const isVADMetrics = (metrics) => {
-  return !!metrics.inferenceCount;
-};
-const isPipelineEOUMetrics = (metrics) => {
-  return !!metrics.endOfUtteranceDelay;
-};
-const isTTSMetrics = (metrics) => {
-  return !!metrics.ttfb;
-};
-const isPipelineTTSMetrics = (metrics) => {
-  return isTTSMetrics(metrics) && !!metrics.sequenceId;
-};
-const isSTTMetrics = (metrics) => {
-  return !(isLLMMetrics(metrics) || isVADMetrics(metrics) || isPipelineEOUMetrics(metrics) || isTTSMetrics(metrics));
-};
 export {
-  isLLMMetrics,
-  isPipelineEOUMetrics,
-  isPipelineLLMMetrics,
-  isPipelineTTSMetrics,
-  isSTTMetrics,
-  isTTSMetrics,
-  isVADMetrics,
   logMetrics
 };
 //# sourceMappingURL=utils.js.map

package/dist/metrics/utils.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/metrics/utils.ts"],"sourcesContent":["// SPDX-FileCopyrightText: 2024 LiveKit, Inc.\n//\n// SPDX-License-Identifier: Apache-2.0\nimport { log } from '../log.js';\nimport type {\n  AgentMetrics,\n  LLMMetrics,\n  PipelineEOUMetrics,\n  PipelineLLMMetrics,\n  PipelineTTSMetrics,\n  STTMetrics,\n  TTSMetrics,\n  VADMetrics,\n} from './base.js';\n\nexport const logMetrics = (metrics: AgentMetrics) => {\n  const logger = log();\n  if (isPipelineLLMMetrics(metrics)) {\n    logger\n      .child({\n        sequenceId: metrics.sequenceId,\n        ttft: metrics.ttft,\n        inputTokens: metrics.promptTokens,\n        outputTokens: metrics.completionTokens,\n        tokensPerSecond: metrics.tokensPerSecond,\n      })\n      .info('Pipeline LLM metrics');\n  } else if (isLLMMetrics(metrics)) {\n    logger\n      .child({\n        ttft: metrics.ttft,\n        inputTokens: metrics.promptTokens,\n        outputTokens: metrics.completionTokens,\n        tokensPerSecond: metrics.tokensPerSecond,\n      })\n      .info('LLM metrics');\n  } else if (isPipelineTTSMetrics(metrics)) {\n    logger\n      .child({\n        sequenceId: metrics.sequenceId,\n        ttfb: metrics.ttfb,\n        audioDuration: metrics.audioDuration,\n      })\n      .info('Pipeline TTS metrics');\n  } else if (isTTSMetrics(metrics)) {\n    logger\n      .child({\n        ttfb: metrics.ttfb,\n        audioDuration: metrics.audioDuration,\n      })\n      .info('TTS metrics');\n  } else if (isPipelineEOUMetrics(metrics)) {\n    logger\n      .child({\n        sequenceId: metrics.sequenceId,\n        endOfUtteranceDelay: metrics.endOfUtteranceDelay,\n        transcriptionDelay: metrics.transcriptionDelay,\n      })\n      .info('Pipeline EOU metrics');\n  } else if (isSTTMetrics(metrics)) {\n    logger\n      .child({\n        audioDuration: metrics.audioDuration,\n      })\n      .info('STT metrics');\n  }\n};\n\nexport const isLLMMetrics = (metrics: AgentMetrics): metrics is LLMMetrics => {\n  return !!(metrics as LLMMetrics).ttft;\n};\n\nexport const isPipelineLLMMetrics = (metrics: AgentMetrics): metrics is PipelineLLMMetrics => {\n  return isLLMMetrics(metrics) && !!(metrics as PipelineLLMMetrics).sequenceId;\n};\n\nexport const isVADMetrics = (metrics: AgentMetrics): metrics is VADMetrics => {\n  return !!(metrics as VADMetrics).inferenceCount;\n};\n\nexport const isPipelineEOUMetrics = (metrics: AgentMetrics): metrics is PipelineEOUMetrics => {\n  return !!(metrics as PipelineEOUMetrics).endOfUtteranceDelay;\n};\n\nexport const isTTSMetrics = (metrics: AgentMetrics): metrics is TTSMetrics => {\n  return !!(metrics as TTSMetrics).ttfb;\n};\n\nexport const isPipelineTTSMetrics = (metrics: AgentMetrics): metrics is PipelineTTSMetrics => {\n  return isTTSMetrics(metrics) && !!(metrics as PipelineTTSMetrics).sequenceId;\n};\n\nexport const isSTTMetrics = (metrics: AgentMetrics): metrics is STTMetrics => {\n  return !(\n    isLLMMetrics(metrics) ||\n    isVADMetrics(metrics) ||\n    isPipelineEOUMetrics(metrics) ||\n    isTTSMetrics(metrics)\n  );\n};\n"],"mappings":"AAGA,SAAS,WAAW;AAYb,MAAM,aAAa,CAAC,YAA0B;AACnD,QAAM,SAAS,IAAI;AACnB,MAAI,qBAAqB,OAAO,GAAG;AACjC,WACG,MAAM;AAAA,MACL,YAAY,QAAQ;AAAA,MACpB,MAAM,QAAQ;AAAA,MACd,aAAa,QAAQ;AAAA,MACrB,cAAc,QAAQ;AAAA,MACtB,iBAAiB,QAAQ;AAAA,IAC3B,CAAC,EACA,KAAK,sBAAsB;AAAA,EAChC,WAAW,aAAa,OAAO,GAAG;AAChC,WACG,MAAM;AAAA,MACL,MAAM,QAAQ;AAAA,MACd,aAAa,QAAQ;AAAA,MACrB,cAAc,QAAQ;AAAA,MACtB,iBAAiB,QAAQ;AAAA,IAC3B,CAAC,EACA,KAAK,aAAa;AAAA,EACvB,WAAW,qBAAqB,OAAO,GAAG;AACxC,WACG,MAAM;AAAA,MACL,YAAY,QAAQ;AAAA,MACpB,MAAM,QAAQ;AAAA,MACd,eAAe,QAAQ;AAAA,IACzB,CAAC,EACA,KAAK,sBAAsB;AAAA,EAChC,WAAW,aAAa,OAAO,GAAG;AAChC,WACG,MAAM;AAAA,MACL,MAAM,QAAQ;AAAA,MACd,eAAe,QAAQ;AAAA,IACzB,CAAC,EACA,KAAK,aAAa;AAAA,EACvB,WAAW,qBAAqB,OAAO,GAAG;AACxC,WACG,MAAM;AAAA,MACL,YAAY,QAAQ;AAAA,MACpB,qBAAqB,QAAQ;AAAA,MAC7B,oBAAoB,QAAQ;AAAA,IAC9B,CAAC,EACA,KAAK,sBAAsB;AAAA,EAChC,WAAW,aAAa,OAAO,GAAG;AAChC,WACG,MAAM;AAAA,MACL,eAAe,QAAQ;AAAA,IACzB,CAAC,EACA,KAAK,aAAa;AAAA,EACvB;AACF;AAEO,MAAM,eAAe,CAAC,YAAiD;AAC5E,SAAO,CAAC,CAAE,QAAuB;AACnC;AAEO,MAAM,uBAAuB,CAAC,YAAyD;AAC5F,SAAO,aAAa,OAAO,KAAK,CAAC,CAAE,QAA+B;AACpE;AAEO,MAAM,eAAe,CAAC,YAAiD;AAC5E,SAAO,CAAC,CAAE,QAAuB;AACnC;AAEO,MAAM,uBAAuB,CAAC,YAAyD;AAC5F,SAAO,CAAC,CAAE,QAA+B;AAC3C;AAEO,MAAM,eAAe,CAAC,YAAiD;AAC5E,SAAO,CAAC,CAAE,QAAuB;AACnC;AAEO,MAAM,uBAAuB,CAAC,YAAyD;AAC5F,SAAO,aAAa,OAAO,KAAK,CAAC,CAAE,QAA+B;AACpE;AAEO,MAAM,eAAe,CAAC,YAAiD;AAC5E,SAAO,EACL,aAAa,OAAO,KACpB,aAAa,OAAO,KACpB,qBAAqB,OAAO,KAC5B,aAAa,OAAO;AAExB;","names":[]}
+{"version":3,"sources":["../../src/metrics/utils.ts"],"sourcesContent":["// SPDX-FileCopyrightText: 2024 LiveKit, Inc.\n//\n// SPDX-License-Identifier: Apache-2.0\nimport { log } from '../log.js';\nimport type { AgentMetrics } from './base.js';\n\nfunction roundTwoDecimals(value: number) {\n  return Math.round(value * 100) / 100;\n}\n\nexport const logMetrics = (metrics: AgentMetrics) => {\n  const logger = log();\n  if (metrics.type === 'llm_metrics') {\n    logger\n      .child({\n        ttft: roundTwoDecimals(metrics.ttft),\n        inputTokens: metrics.promptTokens,\n        promptCachedTokens: metrics.promptCachedTokens,\n        outputTokens: metrics.completionTokens,\n        tokensPerSecond: roundTwoDecimals(metrics.tokensPerSecond),\n      })\n      .info('LLM metrics');\n  } else if (metrics.type === 'realtime_model_metrics') {\n    logger\n      .child({\n        ttft: roundTwoDecimals(metrics.ttft),\n        input_tokens: metrics.inputTokens,\n        cached_input_tokens: metrics.inputTokenDetails.cachedTokens,\n        output_tokens: metrics.outputTokens,\n        total_tokens: metrics.totalTokens,\n        tokens_per_second: roundTwoDecimals(metrics.tokensPerSecond),\n      })\n      .info('RealtimeModel metrics');\n  } else if (metrics.type === 'tts_metrics') {\n    logger\n      .child({\n        ttfb: roundTwoDecimals(metrics.ttfb),\n        audioDuration: metrics.audioDuration,\n      })\n      .info('TTS metrics');\n  } else if (metrics.type === 'eou_metrics') {\n    logger\n      .child({\n        end_of_utterance_delay: roundTwoDecimals(metrics.endOfUtteranceDelay),\n        transcription_delay: roundTwoDecimals(metrics.transcriptionDelay),\n      })\n      .info('EOU metrics');\n  } else if (metrics.type === 'stt_metrics') {\n    logger\n      .child({\n        audioDuration: metrics.audioDuration,\n      })\n      .info('STT metrics');\n  }\n};\n"],"mappings":"AAGA,SAAS,WAAW;AAGpB,SAAS,iBAAiB,OAAe;AACvC,SAAO,KAAK,MAAM,QAAQ,GAAG,IAAI;AACnC;AAEO,MAAM,aAAa,CAAC,YAA0B;AACnD,QAAM,SAAS,IAAI;AACnB,MAAI,QAAQ,SAAS,eAAe;AAClC,WACG,MAAM;AAAA,MACL,MAAM,iBAAiB,QAAQ,IAAI;AAAA,MACnC,aAAa,QAAQ;AAAA,MACrB,oBAAoB,QAAQ;AAAA,MAC5B,cAAc,QAAQ;AAAA,MACtB,iBAAiB,iBAAiB,QAAQ,eAAe;AAAA,IAC3D,CAAC,EACA,KAAK,aAAa;AAAA,EACvB,WAAW,QAAQ,SAAS,0BAA0B;AACpD,WACG,MAAM;AAAA,MACL,MAAM,iBAAiB,QAAQ,IAAI;AAAA,MACnC,cAAc,QAAQ;AAAA,MACtB,qBAAqB,QAAQ,kBAAkB;AAAA,MAC/C,eAAe,QAAQ;AAAA,MACvB,cAAc,QAAQ;AAAA,MACtB,mBAAmB,iBAAiB,QAAQ,eAAe;AAAA,IAC7D,CAAC,EACA,KAAK,uBAAuB;AAAA,EACjC,WAAW,QAAQ,SAAS,eAAe;AACzC,WACG,MAAM;AAAA,MACL,MAAM,iBAAiB,QAAQ,IAAI;AAAA,MACnC,eAAe,QAAQ;AAAA,IACzB,CAAC,EACA,KAAK,aAAa;AAAA,EACvB,WAAW,QAAQ,SAAS,eAAe;AACzC,WACG,MAAM;AAAA,MACL,wBAAwB,iBAAiB,QAAQ,mBAAmB;AAAA,MACpE,qBAAqB,iBAAiB,QAAQ,kBAAkB;AAAA,IAClE,CAAC,EACA,KAAK,aAAa;AAAA,EACvB,WAAW,QAAQ,SAAS,eAAe;AACzC,WACG,MAAM;AAAA,MACL,eAAe,QAAQ;AAAA,IACzB,CAAC,EACA,KAAK,aAAa;AAAA,EACvB;AACF;","names":[]}

package/dist/multimodal/index.cjs

@@ -15,11 +15,9 @@ var __reExport = (target, mod, secondTarget) => (__copyProps(target, mod, "defau
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 var multimodal_exports = {};
 module.exports = __toCommonJS(multimodal_exports);
-__reExport(multimodal_exports, require("./multimodal_agent.cjs"), module.exports);
 __reExport(multimodal_exports, require("./agent_playout.cjs"), module.exports);
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
-  ...require("./multimodal_agent.cjs"),
   ...require("./agent_playout.cjs")
 });
 //# sourceMappingURL=index.cjs.map

package/dist/multimodal/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/multimodal/index.ts"],"sourcesContent":["// SPDX-FileCopyrightText: 2024 LiveKit, Inc.\n//\n// SPDX-License-Identifier: Apache-2.0\nexport * from './multimodal_agent.js';\nexport * from './agent_playout.js';\n"],"mappings":";;;;;;;;;;;;;;;AAAA;AAAA;AAGA,+BAAc,kCAHd;AAIA,+BAAc,+BAJd;","names":[]}
+{"version":3,"sources":["../../src/multimodal/index.ts"],"sourcesContent":["// SPDX-FileCopyrightText: 2024 LiveKit, Inc.\n//\n// SPDX-License-Identifier: Apache-2.0\nexport * from './agent_playout.js';\n"],"mappings":";;;;;;;;;;;;;;;AAAA;AAAA;AAGA,+BAAc,+BAHd;","names":[]}

package/dist/multimodal/index.d.cts

@@ -1,3 +1,2 @@
-export * from './multimodal_agent.js';
 export * from './agent_playout.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/multimodal/index.d.ts

@@ -1,3 +1,2 @@
-export * from './multimodal_agent.js';
 export * from './agent_playout.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/multimodal/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/multimodal/index.ts"],"names":[],"mappings":"AAGA,cAAc,uBAAuB,CAAC;AACtC,cAAc,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/multimodal/index.ts"],"names":[],"mappings":"AAGA,cAAc,oBAAoB,CAAC"}

package/dist/multimodal/index.js

@@ -1,3 +1,2 @@
-export * from "./multimodal_agent.js";
 export * from "./agent_playout.js";
 //# sourceMappingURL=index.js.map

package/dist/multimodal/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/multimodal/index.ts"],"sourcesContent":["// SPDX-FileCopyrightText: 2024 LiveKit, Inc.\n//\n// SPDX-License-Identifier: Apache-2.0\nexport * from './multimodal_agent.js';\nexport * from './agent_playout.js';\n"],"mappings":"AAGA,cAAc;AACd,cAAc;","names":[]}
+{"version":3,"sources":["../../src/multimodal/index.ts"],"sourcesContent":["// SPDX-FileCopyrightText: 2024 LiveKit, Inc.\n//\n// SPDX-License-Identifier: Apache-2.0\nexport * from './agent_playout.js';\n"],"mappings":"AAGA,cAAc;","names":[]}

package/dist/plugin.cjs

@@ -18,19 +18,34 @@ var __copyProps = (to, from, except, desc) => {
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 var plugin_exports = {};
 __export(plugin_exports, {
-  Plugin: () => Plugin
+  Plugin: () => Plugin,
+  PluginEventTypes: () => PluginEventTypes
 });
 module.exports = __toCommonJS(plugin_exports);
+var import_events = require("events");
+var PluginEventTypes = /* @__PURE__ */ ((PluginEventTypes2) => {
+  PluginEventTypes2["PluginRegistered"] = "plugin_registered";
+  return PluginEventTypes2;
+})(PluginEventTypes || {});
 class Plugin {
-  registeredPlugins = [];
+  static registeredPlugins = [];
+  static emitter = new import_events.EventEmitter();
   #title;
   #version;
-  constructor(title, version) {
-    this.#title = title;
-    this.#version = version;
+  #package;
+  constructor(opts) {
+    this.#title = opts.title;
+    this.#version = opts.version;
+    this.#package = opts.package;
   }
-  static registerPlugins(plugin) {
-    plugin.registeredPlugins.push(plugin);
+  static registerPlugin(plugin) {
+    Plugin.registeredPlugins.push(plugin);
+    Plugin.emitter.emit("plugin_registered" /* PluginRegistered */, plugin);
+  }
+  downloadFiles() {
+  }
+  get package() {
+    return this.#package;
   }
   get title() {
     return this.#title;
@@ -41,6 +56,7 @@ class Plugin {
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
-  Plugin
+  Plugin,
+  PluginEventTypes
 });
 //# sourceMappingURL=plugin.cjs.map

package/dist/plugin.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/plugin.ts"],"sourcesContent":["// SPDX-FileCopyrightText: 2024 LiveKit, Inc.\n//\n// SPDX-License-Identifier: Apache-2.0\n\nexport abstract class Plugin {\n  registeredPlugins: Plugin[] = [];\n  #title: string;\n  #version: string;\n\n  constructor(title: string, version: string) {\n    this.#title = title;\n    this.#version = version;\n  }\n\n  public static registerPlugins(plugin: Plugin) {\n    plugin.registeredPlugins.push(plugin);\n  }\n\n  abstract downloadFiles(): void;\n\n  get title(): string {\n    return this.#title;\n  }\n\n  get version(): string {\n    return this.#version;\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAIO,MAAe,OAAO;AAAA,EAC3B,oBAA8B,CAAC;AAAA,EAC/B;AAAA,EACA;AAAA,EAEA,YAAY,OAAe,SAAiB;AAC1C,SAAK,SAAS;AACd,SAAK,WAAW;AAAA,EAClB;AAAA,EAEA,OAAc,gBAAgB,QAAgB;AAC5C,WAAO,kBAAkB,KAAK,MAAM;AAAA,EACtC;AAAA,EAIA,IAAI,QAAgB;AAClB,WAAO,KAAK;AAAA,EACd;AAAA,EAEA,IAAI,UAAkB;AACpB,WAAO,KAAK;AAAA,EACd;AACF;","names":[]}
+{"version":3,"sources":["../src/plugin.ts"],"sourcesContent":["// SPDX-FileCopyrightText: 2025 LiveKit, Inc.\n//\n// SPDX-License-Identifier: Apache-2.0\nimport { EventEmitter } from 'events';\n\nexport enum PluginEventTypes {\n  PluginRegistered = 'plugin_registered',\n}\n\nexport type PluginEventMap = {\n  [PluginEventTypes.PluginRegistered]: [Plugin];\n};\n\nexport abstract class Plugin {\n  static registeredPlugins = [] as Plugin[];\n  static emitter = new EventEmitter<PluginEventMap>();\n\n  #title: string;\n  #version: string;\n  #package: string;\n\n  constructor(opts: { title: string; version: string; package: string }) {\n    this.#title = opts.title;\n    this.#version = opts.version;\n    this.#package = opts.package;\n  }\n\n  static registerPlugin(plugin: Plugin) {\n    Plugin.registeredPlugins.push(plugin);\n    Plugin.emitter.emit(PluginEventTypes.PluginRegistered, plugin);\n  }\n\n  downloadFiles() {}\n\n  get package(): string {\n    return this.#package;\n  }\n\n  get title(): string {\n    return this.#title;\n  }\n\n  get version(): string {\n    return this.#version;\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAGA,oBAA6B;AAEtB,IAAK,mBAAL,kBAAKA,sBAAL;AACL,EAAAA,kBAAA,sBAAmB;AADT,SAAAA;AAAA,GAAA;AAQL,MAAe,OAAO;AAAA,EAC3B,OAAO,oBAAoB,CAAC;AAAA,EAC5B,OAAO,UAAU,IAAI,2BAA6B;AAAA,EAElD;AAAA,EACA;AAAA,EACA;AAAA,EAEA,YAAY,MAA2D;AACrE,SAAK,SAAS,KAAK;AACnB,SAAK,WAAW,KAAK;AACrB,SAAK,WAAW,KAAK;AAAA,EACvB;AAAA,EAEA,OAAO,eAAe,QAAgB;AACpC,WAAO,kBAAkB,KAAK,MAAM;AACpC,WAAO,QAAQ,KAAK,4CAAmC,MAAM;AAAA,EAC/D;AAAA,EAEA,gBAAgB;AAAA,EAAC;AAAA,EAEjB,IAAI,UAAkB;AACpB,WAAO,KAAK;AAAA,EACd;AAAA,EAEA,IAAI,QAAgB;AAClB,WAAO,KAAK;AAAA,EACd;AAAA,EAEA,IAAI,UAAkB;AACpB,WAAO,KAAK;AAAA,EACd;AACF;","names":["PluginEventTypes"]}

package/dist/plugin.d.cts

@@ -1,9 +1,23 @@
+/// <reference types="node" resolution-mode="require"/>
+import { EventEmitter } from 'events';
+export declare enum PluginEventTypes {
+    PluginRegistered = "plugin_registered"
+}
+export type PluginEventMap = {
+    [PluginEventTypes.PluginRegistered]: [Plugin];
+};
 export declare abstract class Plugin {
     #private;
-    registeredPlugins: Plugin[];
-    constructor(title: string, version: string);
-    static registerPlugins(plugin: Plugin): void;
-    abstract downloadFiles(): void;
+    static registeredPlugins: Plugin[];
+    static emitter: EventEmitter<PluginEventMap>;
+    constructor(opts: {
+        title: string;
+        version: string;
+        package: string;
+    });
+    static registerPlugin(plugin: Plugin): void;
+    downloadFiles(): void;
+    get package(): string;
     get title(): string;
     get version(): string;
 }

package/dist/plugin.d.ts

@@ -1,9 +1,23 @@
+/// <reference types="node" resolution-mode="require"/>
+import { EventEmitter } from 'events';
+export declare enum PluginEventTypes {
+    PluginRegistered = "plugin_registered"
+}
+export type PluginEventMap = {
+    [PluginEventTypes.PluginRegistered]: [Plugin];
+};
 export declare abstract class Plugin {
     #private;
-    registeredPlugins: Plugin[];
-    constructor(title: string, version: string);
-    static registerPlugins(plugin: Plugin): void;
-    abstract downloadFiles(): void;
+    static registeredPlugins: Plugin[];
+    static emitter: EventEmitter<PluginEventMap>;
+    constructor(opts: {
+        title: string;
+        version: string;
+        package: string;
+    });
+    static registerPlugin(plugin: Plugin): void;
+    downloadFiles(): void;
+    get package(): string;
     get title(): string;
     get version(): string;
 }

package/dist/plugin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAIA,8BAAsB,MAAM;;IAC1B,iBAAiB,EAAE,MAAM,EAAE,CAAM;gBAIrB,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;WAK5B,eAAe,CAAC,MAAM,EAAE,MAAM;IAI5C,QAAQ,CAAC,aAAa,IAAI,IAAI;IAE9B,IAAI,KAAK,IAAI,MAAM,CAElB;IAED,IAAI,OAAO,IAAI,MAAM,CAEpB;CACF"}
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":";AAGA,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAEtC,oBAAY,gBAAgB;IAC1B,gBAAgB,sBAAsB;CACvC;AAED,MAAM,MAAM,cAAc,GAAG;IAC3B,CAAC,gBAAgB,CAAC,gBAAgB,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC;CAC/C,CAAC;AAEF,8BAAsB,MAAM;;IAC1B,MAAM,CAAC,iBAAiB,WAAkB;IAC1C,MAAM,CAAC,OAAO,+BAAsC;gBAMxC,IAAI,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE;IAMrE,MAAM,CAAC,cAAc,CAAC,MAAM,EAAE,MAAM;IAKpC,aAAa;IAEb,IAAI,OAAO,IAAI,MAAM,CAEpB;IAED,IAAI,KAAK,IAAI,MAAM,CAElB;IAED,IAAI,OAAO,IAAI,MAAM,CAEpB;CACF"}

package/dist/plugin.js

@@ -1,13 +1,27 @@
+import { EventEmitter } from "events";
+var PluginEventTypes = /* @__PURE__ */ ((PluginEventTypes2) => {
+  PluginEventTypes2["PluginRegistered"] = "plugin_registered";
+  return PluginEventTypes2;
+})(PluginEventTypes || {});
 class Plugin {
-  registeredPlugins = [];
+  static registeredPlugins = [];
+  static emitter = new EventEmitter();
   #title;
   #version;
-  constructor(title, version) {
-    this.#title = title;
-    this.#version = version;
+  #package;
+  constructor(opts) {
+    this.#title = opts.title;
+    this.#version = opts.version;
+    this.#package = opts.package;
   }
-  static registerPlugins(plugin) {
-    plugin.registeredPlugins.push(plugin);
+  static registerPlugin(plugin) {
+    Plugin.registeredPlugins.push(plugin);
+    Plugin.emitter.emit("plugin_registered" /* PluginRegistered */, plugin);
+  }
+  downloadFiles() {
+  }
+  get package() {
+    return this.#package;
   }
   get title() {
     return this.#title;
@@ -17,6 +31,7 @@ class Plugin {
   }
 }
 export {
-  Plugin
+  Plugin,
+  PluginEventTypes
 };
 //# sourceMappingURL=plugin.js.map

package/dist/plugin.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/plugin.ts"],"sourcesContent":["// SPDX-FileCopyrightText: 2024 LiveKit, Inc.\n//\n// SPDX-License-Identifier: Apache-2.0\n\nexport abstract class Plugin {\n  registeredPlugins: Plugin[] = [];\n  #title: string;\n  #version: string;\n\n  constructor(title: string, version: string) {\n    this.#title = title;\n    this.#version = version;\n  }\n\n  public static registerPlugins(plugin: Plugin) {\n    plugin.registeredPlugins.push(plugin);\n  }\n\n  abstract downloadFiles(): void;\n\n  get title(): string {\n    return this.#title;\n  }\n\n  get version(): string {\n    return this.#version;\n  }\n}\n"],"mappings":"AAIO,MAAe,OAAO;AAAA,EAC3B,oBAA8B,CAAC;AAAA,EAC/B;AAAA,EACA;AAAA,EAEA,YAAY,OAAe,SAAiB;AAC1C,SAAK,SAAS;AACd,SAAK,WAAW;AAAA,EAClB;AAAA,EAEA,OAAc,gBAAgB,QAAgB;AAC5C,WAAO,kBAAkB,KAAK,MAAM;AAAA,EACtC;AAAA,EAIA,IAAI,QAAgB;AAClB,WAAO,KAAK;AAAA,EACd;AAAA,EAEA,IAAI,UAAkB;AACpB,WAAO,KAAK;AAAA,EACd;AACF;","names":[]}
+{"version":3,"sources":["../src/plugin.ts"],"sourcesContent":["// SPDX-FileCopyrightText: 2025 LiveKit, Inc.\n//\n// SPDX-License-Identifier: Apache-2.0\nimport { EventEmitter } from 'events';\n\nexport enum PluginEventTypes {\n  PluginRegistered = 'plugin_registered',\n}\n\nexport type PluginEventMap = {\n  [PluginEventTypes.PluginRegistered]: [Plugin];\n};\n\nexport abstract class Plugin {\n  static registeredPlugins = [] as Plugin[];\n  static emitter = new EventEmitter<PluginEventMap>();\n\n  #title: string;\n  #version: string;\n  #package: string;\n\n  constructor(opts: { title: string; version: string; package: string }) {\n    this.#title = opts.title;\n    this.#version = opts.version;\n    this.#package = opts.package;\n  }\n\n  static registerPlugin(plugin: Plugin) {\n    Plugin.registeredPlugins.push(plugin);\n    Plugin.emitter.emit(PluginEventTypes.PluginRegistered, plugin);\n  }\n\n  downloadFiles() {}\n\n  get package(): string {\n    return this.#package;\n  }\n\n  get title(): string {\n    return this.#title;\n  }\n\n  get version(): string {\n    return this.#version;\n  }\n}\n"],"mappings":"AAGA,SAAS,oBAAoB;AAEtB,IAAK,mBAAL,kBAAKA,sBAAL;AACL,EAAAA,kBAAA,sBAAmB;AADT,SAAAA;AAAA,GAAA;AAQL,MAAe,OAAO;AAAA,EAC3B,OAAO,oBAAoB,CAAC;AAAA,EAC5B,OAAO,UAAU,IAAI,aAA6B;AAAA,EAElD;AAAA,EACA;AAAA,EACA;AAAA,EAEA,YAAY,MAA2D;AACrE,SAAK,SAAS,KAAK;AACnB,SAAK,WAAW,KAAK;AACrB,SAAK,WAAW,KAAK;AAAA,EACvB;AAAA,EAEA,OAAO,eAAe,QAAgB;AACpC,WAAO,kBAAkB,KAAK,MAAM;AACpC,WAAO,QAAQ,KAAK,4CAAmC,MAAM;AAAA,EAC/D;AAAA,EAEA,gBAAgB;AAAA,EAAC;AAAA,EAEjB,IAAI,UAAkB;AACpB,WAAO,KAAK;AAAA,EACd;AAAA,EAEA,IAAI,QAAgB;AAClB,WAAO,KAAK;AAAA,EACd;AAAA,EAEA,IAAI,UAAkB;AACpB,WAAO,KAAK;AAAA,EACd;AACF;","names":["PluginEventTypes"]}