@livekit/agents 0.0.0-20260120144724

package/dist/log.js

@@ -0,0 +1,54 @@
+import { Writable } from "node:stream";
+import { multistream, pino } from "pino";
+import { build as pinoPretty } from "pino-pretty";
+import { emitToOtel } from "./telemetry/pino_otel_transport.js";
+let loggerOptions;
+let logger = void 0;
+let otelEnabled = false;
+const log = () => {
+  if (!logger) {
+    throw new TypeError("logger not initialized. did you forget to run initializeLogger()?");
+  }
+  return logger;
+};
+const initializeLogger = ({ pretty, level }) => {
+  loggerOptions = { pretty, level };
+  logger = pino(
+    { level: level || "info" },
+    pretty ? pinoPretty({ colorize: true }) : process.stdout
+  );
+};
+class OtelDestination extends Writable {
+  _write(chunk, _encoding, callback) {
+    try {
+      const line = chunk.toString().trim();
+      if (line) {
+        const logObj = JSON.parse(line);
+        emitToOtel(logObj);
+      }
+    } catch {
+    }
+    callback();
+  }
+}
+const enableOtelLogging = () => {
+  if (otelEnabled || !logger) {
+    console.warn("OTEL logging already enabled or logger not initialized");
+    return;
+  }
+  otelEnabled = true;
+  const { pretty, level } = loggerOptions;
+  const logLevel = level || "info";
+  const streams = [
+    { stream: pretty ? pinoPretty({ colorize: true }) : process.stdout, level: logLevel },
+    { stream: new OtelDestination(), level: "debug" }
+  ];
+  logger = pino({ level: logLevel }, multistream(streams));
+};
+export {
+  enableOtelLogging,
+  initializeLogger,
+  log,
+  loggerOptions
+};
+//# sourceMappingURL=log.js.map

package/dist/log.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/log.ts"],"sourcesContent":["// SPDX-FileCopyrightText: 2024 LiveKit, Inc.\n//\n// SPDX-License-Identifier: Apache-2.0\nimport { Writable } from 'node:stream';\nimport type { DestinationStream, Logger } from 'pino';\nimport { multistream, pino } from 'pino';\nimport { build as pinoPretty } from 'pino-pretty';\nimport { type PinoLogObject, emitToOtel } from './telemetry/pino_otel_transport.js';\n\n/** @internal */\nexport type LoggerOptions = {\n  pretty: boolean;\n  level?: string;\n};\n\n/** @internal */\nexport let loggerOptions: LoggerOptions;\n\n/** @internal */\nlet logger: Logger | undefined = undefined;\n\n/** @internal */\nlet otelEnabled = false;\n\n/** @internal */\nexport const log = () => {\n  if (!logger) {\n    throw new TypeError('logger not initialized. did you forget to run initializeLogger()?');\n  }\n  return logger;\n};\n\n/** @internal */\nexport const initializeLogger = ({ pretty, level }: LoggerOptions) => {\n  loggerOptions = { pretty, level };\n  logger = pino(\n    { level: level || 'info' },\n    pretty ? pinoPretty({ colorize: true }) : process.stdout,\n  );\n};\n\n/**\n * Custom Pino destination that parses JSON logs and emits to OTEL.\n * This receives the FULL serialized log including msg, level, time, etc.\n */\nclass OtelDestination extends Writable {\n  _write(chunk: Buffer, _encoding: string, callback: (error?: Error | null) => void): void {\n    try {\n      const line = chunk.toString().trim();\n      if (line) {\n        const logObj = JSON.parse(line) as PinoLogObject;\n        emitToOtel(logObj);\n      }\n    } catch {\n      // Ignore parse errors (e.g., non-JSON lines)\n    }\n    callback();\n  }\n}\n\n/**\n * Enable OTEL logging by reconfiguring the logger with multistream.\n * Uses a custom destination that receives full JSON logs (with msg, level, time).\n *\n * @internal\n */\nexport const enableOtelLogging = () => {\n  if (otelEnabled || !logger) {\n    console.warn('OTEL logging already enabled or logger not initialized');\n    return;\n  }\n  otelEnabled = true;\n\n  const { pretty, level } = loggerOptions;\n\n  const logLevel = level || 'info';\n  const streams: { stream: DestinationStream; level: string }[] = [\n    { stream: pretty ? pinoPretty({ colorize: true }) : process.stdout, level: logLevel },\n    { stream: new OtelDestination(), level: 'debug' },\n  ];\n\n  logger = pino({ level: logLevel }, multistream(streams));\n};\n"],"mappings":"AAGA,SAAS,gBAAgB;AAEzB,SAAS,aAAa,YAAY;AAClC,SAAS,SAAS,kBAAkB;AACpC,SAA6B,kBAAkB;AASxC,IAAI;AAGX,IAAI,SAA6B;AAGjC,IAAI,cAAc;AAGX,MAAM,MAAM,MAAM;AACvB,MAAI,CAAC,QAAQ;AACX,UAAM,IAAI,UAAU,mEAAmE;AAAA,EACzF;AACA,SAAO;AACT;AAGO,MAAM,mBAAmB,CAAC,EAAE,QAAQ,MAAM,MAAqB;AACpE,kBAAgB,EAAE,QAAQ,MAAM;AAChC,WAAS;AAAA,IACP,EAAE,OAAO,SAAS,OAAO;AAAA,IACzB,SAAS,WAAW,EAAE,UAAU,KAAK,CAAC,IAAI,QAAQ;AAAA,EACpD;AACF;AAMA,MAAM,wBAAwB,SAAS;AAAA,EACrC,OAAO,OAAe,WAAmB,UAAgD;AACvF,QAAI;AACF,YAAM,OAAO,MAAM,SAAS,EAAE,KAAK;AACnC,UAAI,MAAM;AACR,cAAM,SAAS,KAAK,MAAM,IAAI;AAC9B,mBAAW,MAAM;AAAA,MACnB;AAAA,IACF,QAAQ;AAAA,IAER;AACA,aAAS;AAAA,EACX;AACF;AAQO,MAAM,oBAAoB,MAAM;AACrC,MAAI,eAAe,CAAC,QAAQ;AAC1B,YAAQ,KAAK,wDAAwD;AACrE;AAAA,EACF;AACA,gBAAc;AAEd,QAAM,EAAE,QAAQ,MAAM,IAAI;AAE1B,QAAM,WAAW,SAAS;AAC1B,QAAM,UAA0D;AAAA,IAC9D,EAAE,QAAQ,SAAS,WAAW,EAAE,UAAU,KAAK,CAAC,IAAI,QAAQ,QAAQ,OAAO,SAAS;AAAA,IACpF,EAAE,QAAQ,IAAI,gBAAgB,GAAG,OAAO,QAAQ;AAAA,EAClD;AAEA,WAAS,KAAK,EAAE,OAAO,SAAS,GAAG,YAAY,OAAO,CAAC;AACzD;","names":[]}

package/dist/metrics/base.cjs

@@ -0,0 +1,17 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var base_exports = {};
+module.exports = __toCommonJS(base_exports);
+//# sourceMappingURL=base.cjs.map

package/dist/metrics/base.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/metrics/base.ts"],"sourcesContent":["// SPDX-FileCopyrightText: 2024 LiveKit, Inc.\n//\n// SPDX-License-Identifier: Apache-2.0\n\nexport type AgentMetrics =\n  | STTMetrics\n  | LLMMetrics\n  | TTSMetrics\n  | VADMetrics\n  | EOUMetrics\n  | RealtimeModelMetrics;\n\nexport type LLMMetrics = {\n  type: 'llm_metrics';\n  label: string;\n  requestId: string;\n  timestamp: number;\n  /** Duration of the request in milliseconds. */\n  durationMs: number;\n  /** Time to first token in milliseconds. */\n  ttftMs: number;\n  cancelled: boolean;\n  completionTokens: number;\n  promptTokens: number;\n  promptCachedTokens: number;\n  totalTokens: number;\n  tokensPerSecond: number;\n  speechId?: string;\n};\n\nexport type STTMetrics = {\n  type: 'stt_metrics';\n  label: string;\n  requestId: string;\n  timestamp: number;\n  /**\n   * The request duration in milliseconds, 0.0 if the STT is streaming.\n   */\n  durationMs: number;\n  /**\n   * The duration of the pushed audio in milliseconds.\n   */\n  audioDurationMs: number;\n  /**\n   * Whether the STT is streaming (e.g using websocket).\n   */\n  streamed: boolean;\n};\n\nexport type TTSMetrics = {\n  type: 'tts_metrics';\n  label: string;\n  requestId: string;\n  timestamp: number;\n  /** Time to first byte in milliseconds. */\n  ttfbMs: number;\n  /** Total synthesis duration in milliseconds. */\n  durationMs: number;\n  /** Generated audio duration in milliseconds. */\n  audioDurationMs: number;\n  cancelled: boolean;\n  charactersCount: number;\n  streamed: boolean;\n  segmentId?: string;\n  speechId?: string;\n};\n\nexport type VADMetrics = {\n  type: 'vad_metrics';\n  label: string;\n  timestamp: number;\n  idleTimeMs: number;\n  inferenceDurationTotalMs: number;\n  inferenceCount: number;\n};\n\nexport type EOUMetrics = {\n  type: 'eou_metrics';\n  timestamp: number;\n  /**\n   * Amount of time between the end of speech from VAD and the decision to end the user's turn.\n   * Set to 0.0 if the end of speech was not detected.\n   */\n  endOfUtteranceDelayMs: number;\n  /**\n   * Time taken to obtain the transcript after the end of the user's speech.\n   * Set to 0.0 if the end of speech was not detected.\n   */\n  transcriptionDelayMs: number;\n  /**\n   * Time taken to invoke the user's `Agent.onUserTurnCompleted` callback.\n   */\n  onUserTurnCompletedDelayMs: number;\n  /**\n   * The time the user stopped speaking.\n   */\n  lastSpeakingTimeMs: number;\n  /**\n   * The ID of the speech handle.\n   */\n  speechId?: string;\n};\n\nexport type RealtimeModelMetricsCachedTokenDetails = {\n  audioTokens: number;\n  textTokens: number;\n  imageTokens: number;\n};\n\nexport type RealtimeModelMetricsInputTokenDetails = {\n  audioTokens: number;\n  textTokens: number;\n  imageTokens: number;\n  cachedTokens: number;\n  cachedTokensDetails?: RealtimeModelMetricsCachedTokenDetails;\n};\n\nexport type RealtimeModelMetricsOutputTokenDetails = {\n  textTokens: number;\n  audioTokens: number;\n  imageTokens: number;\n};\n\nexport type RealtimeModelMetrics = {\n  type: 'realtime_model_metrics';\n  label: string;\n  requestId: string;\n  /**\n   * The timestamp of the response creation.\n   */\n  timestamp: number;\n  /**\n   * The duration of the response from created to done in milliseconds.\n   */\n  durationMs: number;\n  /**\n   * Time to first audio token in milliseconds. -1 if no audio token was sent.\n   */\n  ttftMs: number;\n  /**\n   * Whether the request was cancelled.\n   */\n  cancelled: boolean;\n  /**\n   * The number of input tokens used in the Response, including text and audio tokens.\n   */\n  inputTokens: number;\n  /**\n   * The number of output tokens sent in the Response, including text and audio tokens.\n   */\n  outputTokens: number;\n  /**\n   * The total number of tokens in the Response.\n   */\n  totalTokens: number;\n  /**\n   * The number of tokens per second.\n   */\n  tokensPerSecond: number;\n  /**\n   * Details about the input tokens used in the Response.\n   */\n  inputTokenDetails: RealtimeModelMetricsInputTokenDetails;\n  /**\n   * Details about the output tokens used in the Response.\n   */\n  outputTokenDetails: RealtimeModelMetricsOutputTokenDetails;\n};\n"],"mappings":";;;;;;;;;;;;;;AAAA;AAAA;","names":[]}

package/dist/metrics/base.d.cts

@@ -0,0 +1,150 @@
+export type AgentMetrics = STTMetrics | LLMMetrics | TTSMetrics | VADMetrics | EOUMetrics | RealtimeModelMetrics;
+export type LLMMetrics = {
+    type: 'llm_metrics';
+    label: string;
+    requestId: string;
+    timestamp: number;
+    /** Duration of the request in milliseconds. */
+    durationMs: number;
+    /** Time to first token in milliseconds. */
+    ttftMs: number;
+    cancelled: boolean;
+    completionTokens: number;
+    promptTokens: number;
+    promptCachedTokens: number;
+    totalTokens: number;
+    tokensPerSecond: number;
+    speechId?: string;
+};
+export type STTMetrics = {
+    type: 'stt_metrics';
+    label: string;
+    requestId: string;
+    timestamp: number;
+    /**
+     * The request duration in milliseconds, 0.0 if the STT is streaming.
+     */
+    durationMs: number;
+    /**
+     * The duration of the pushed audio in milliseconds.
+     */
+    audioDurationMs: number;
+    /**
+     * Whether the STT is streaming (e.g using websocket).
+     */
+    streamed: boolean;
+};
+export type TTSMetrics = {
+    type: 'tts_metrics';
+    label: string;
+    requestId: string;
+    timestamp: number;
+    /** Time to first byte in milliseconds. */
+    ttfbMs: number;
+    /** Total synthesis duration in milliseconds. */
+    durationMs: number;
+    /** Generated audio duration in milliseconds. */
+    audioDurationMs: number;
+    cancelled: boolean;
+    charactersCount: number;
+    streamed: boolean;
+    segmentId?: string;
+    speechId?: string;
+};
+export type VADMetrics = {
+    type: 'vad_metrics';
+    label: string;
+    timestamp: number;
+    idleTimeMs: number;
+    inferenceDurationTotalMs: number;
+    inferenceCount: number;
+};
+export type EOUMetrics = {
+    type: 'eou_metrics';
+    timestamp: number;
+    /**
+     * Amount of time between the end of speech from VAD and the decision to end the user's turn.
+     * Set to 0.0 if the end of speech was not detected.
+     */
+    endOfUtteranceDelayMs: number;
+    /**
+     * Time taken to obtain the transcript after the end of the user's speech.
+     * Set to 0.0 if the end of speech was not detected.
+     */
+    transcriptionDelayMs: number;
+    /**
+     * Time taken to invoke the user's `Agent.onUserTurnCompleted` callback.
+     */
+    onUserTurnCompletedDelayMs: number;
+    /**
+     * The time the user stopped speaking.
+     */
+    lastSpeakingTimeMs: number;
+    /**
+     * The ID of the speech handle.
+     */
+    speechId?: string;
+};
+export type RealtimeModelMetricsCachedTokenDetails = {
+    audioTokens: number;
+    textTokens: number;
+    imageTokens: number;
+};
+export type RealtimeModelMetricsInputTokenDetails = {
+    audioTokens: number;
+    textTokens: number;
+    imageTokens: number;
+    cachedTokens: number;
+    cachedTokensDetails?: RealtimeModelMetricsCachedTokenDetails;
+};
+export type RealtimeModelMetricsOutputTokenDetails = {
+    textTokens: number;
+    audioTokens: number;
+    imageTokens: number;
+};
+export type RealtimeModelMetrics = {
+    type: 'realtime_model_metrics';
+    label: string;
+    requestId: string;
+    /**
+     * The timestamp of the response creation.
+     */
+    timestamp: number;
+    /**
+     * The duration of the response from created to done in milliseconds.
+     */
+    durationMs: number;
+    /**
+     * Time to first audio token in milliseconds. -1 if no audio token was sent.
+     */
+    ttftMs: number;
+    /**
+     * Whether the request was cancelled.
+     */
+    cancelled: boolean;
+    /**
+     * The number of input tokens used in the Response, including text and audio tokens.
+     */
+    inputTokens: number;
+    /**
+     * The number of output tokens sent in the Response, including text and audio tokens.
+     */
+    outputTokens: number;
+    /**
+     * The total number of tokens in the Response.
+     */
+    totalTokens: number;
+    /**
+     * The number of tokens per second.
+     */
+    tokensPerSecond: number;
+    /**
+     * Details about the input tokens used in the Response.
+     */
+    inputTokenDetails: RealtimeModelMetricsInputTokenDetails;
+    /**
+     * Details about the output tokens used in the Response.
+     */
+    outputTokenDetails: RealtimeModelMetricsOutputTokenDetails;
+};
+//# sourceMappingURL=base.d.ts.map

package/dist/metrics/base.d.ts

@@ -0,0 +1,150 @@
+export type AgentMetrics = STTMetrics | LLMMetrics | TTSMetrics | VADMetrics | EOUMetrics | RealtimeModelMetrics;
+export type LLMMetrics = {
+    type: 'llm_metrics';
+    label: string;
+    requestId: string;
+    timestamp: number;
+    /** Duration of the request in milliseconds. */
+    durationMs: number;
+    /** Time to first token in milliseconds. */
+    ttftMs: number;
+    cancelled: boolean;
+    completionTokens: number;
+    promptTokens: number;
+    promptCachedTokens: number;
+    totalTokens: number;
+    tokensPerSecond: number;
+    speechId?: string;
+};
+export type STTMetrics = {
+    type: 'stt_metrics';
+    label: string;
+    requestId: string;
+    timestamp: number;
+    /**
+     * The request duration in milliseconds, 0.0 if the STT is streaming.
+     */
+    durationMs: number;
+    /**
+     * The duration of the pushed audio in milliseconds.
+     */
+    audioDurationMs: number;
+    /**
+     * Whether the STT is streaming (e.g using websocket).
+     */
+    streamed: boolean;
+};
+export type TTSMetrics = {
+    type: 'tts_metrics';
+    label: string;
+    requestId: string;
+    timestamp: number;
+    /** Time to first byte in milliseconds. */
+    ttfbMs: number;
+    /** Total synthesis duration in milliseconds. */
+    durationMs: number;
+    /** Generated audio duration in milliseconds. */
+    audioDurationMs: number;
+    cancelled: boolean;
+    charactersCount: number;
+    streamed: boolean;
+    segmentId?: string;
+    speechId?: string;
+};
+export type VADMetrics = {
+    type: 'vad_metrics';
+    label: string;
+    timestamp: number;
+    idleTimeMs: number;
+    inferenceDurationTotalMs: number;
+    inferenceCount: number;
+};
+export type EOUMetrics = {
+    type: 'eou_metrics';
+    timestamp: number;
+    /**
+     * Amount of time between the end of speech from VAD and the decision to end the user's turn.
+     * Set to 0.0 if the end of speech was not detected.
+     */
+    endOfUtteranceDelayMs: number;
+    /**
+     * Time taken to obtain the transcript after the end of the user's speech.
+     * Set to 0.0 if the end of speech was not detected.
+     */
+    transcriptionDelayMs: number;
+    /**
+     * Time taken to invoke the user's `Agent.onUserTurnCompleted` callback.
+     */
+    onUserTurnCompletedDelayMs: number;
+    /**
+     * The time the user stopped speaking.
+     */
+    lastSpeakingTimeMs: number;
+    /**
+     * The ID of the speech handle.
+     */
+    speechId?: string;
+};
+export type RealtimeModelMetricsCachedTokenDetails = {
+    audioTokens: number;
+    textTokens: number;
+    imageTokens: number;
+};
+export type RealtimeModelMetricsInputTokenDetails = {
+    audioTokens: number;
+    textTokens: number;
+    imageTokens: number;
+    cachedTokens: number;
+    cachedTokensDetails?: RealtimeModelMetricsCachedTokenDetails;
+};
+export type RealtimeModelMetricsOutputTokenDetails = {
+    textTokens: number;
+    audioTokens: number;
+    imageTokens: number;
+};
+export type RealtimeModelMetrics = {
+    type: 'realtime_model_metrics';
+    label: string;
+    requestId: string;
+    /**
+     * The timestamp of the response creation.
+     */
+    timestamp: number;
+    /**
+     * The duration of the response from created to done in milliseconds.
+     */
+    durationMs: number;
+    /**
+     * Time to first audio token in milliseconds. -1 if no audio token was sent.
+     */
+    ttftMs: number;
+    /**
+     * Whether the request was cancelled.
+     */
+    cancelled: boolean;
+    /**
+     * The number of input tokens used in the Response, including text and audio tokens.
+     */
+    inputTokens: number;
+    /**
+     * The number of output tokens sent in the Response, including text and audio tokens.
+     */
+    outputTokens: number;
+    /**
+     * The total number of tokens in the Response.
+     */
+    totalTokens: number;
+    /**
+     * The number of tokens per second.
+     */
+    tokensPerSecond: number;
+    /**
+     * Details about the input tokens used in the Response.
+     */
+    inputTokenDetails: RealtimeModelMetricsInputTokenDetails;
+    /**
+     * Details about the output tokens used in the Response.
+     */
+    outputTokenDetails: RealtimeModelMetricsOutputTokenDetails;
+};
+//# sourceMappingURL=base.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../src/metrics/base.ts"],"names":[],"mappings":"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"}

package/dist/metrics/base.js

@@ -0,0 +1 @@
+//# sourceMappingURL=base.js.map

package/dist/metrics/base.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/metrics/index.cjs

@@ -0,0 +1,32 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var metrics_exports = {};
+__export(metrics_exports, {
+  UsageCollector: () => import_usage_collector.UsageCollector,
+  logMetrics: () => import_utils.logMetrics
+});
+module.exports = __toCommonJS(metrics_exports);
+var import_usage_collector = require("./usage_collector.cjs");
+var import_utils = require("./utils.cjs");
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  UsageCollector,
+  logMetrics
+});
+//# sourceMappingURL=index.cjs.map

package/dist/metrics/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/metrics/index.ts"],"sourcesContent":["// SPDX-FileCopyrightText: 2024 LiveKit, Inc.\n//\n// SPDX-License-Identifier: Apache-2.0\n\nexport type {\n  AgentMetrics,\n  EOUMetrics,\n  LLMMetrics,\n  RealtimeModelMetrics,\n  STTMetrics,\n  TTSMetrics,\n  VADMetrics,\n} from './base.js';\nexport { UsageCollector, type UsageSummary } from './usage_collector.js';\nexport { logMetrics } from './utils.js';\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAaA,6BAAkD;AAClD,mBAA2B;","names":[]}

package/dist/metrics/index.d.cts

@@ -0,0 +1,4 @@
+export type { AgentMetrics, EOUMetrics, LLMMetrics, RealtimeModelMetrics, STTMetrics, TTSMetrics, VADMetrics, } from './base.js';
+export { UsageCollector, type UsageSummary } from './usage_collector.js';
+export { logMetrics } from './utils.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/metrics/index.d.ts

@@ -0,0 +1,4 @@
+export type { AgentMetrics, EOUMetrics, LLMMetrics, RealtimeModelMetrics, STTMetrics, TTSMetrics, VADMetrics, } from './base.js';
+export { UsageCollector, type UsageSummary } from './usage_collector.js';
+export { logMetrics } from './utils.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/metrics/index.ts"],"names":[],"mappings":"AAIA,YAAY,EACV,YAAY,EACZ,UAAU,EACV,UAAU,EACV,oBAAoB,EACpB,UAAU,EACV,UAAU,EACV,UAAU,GACX,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,cAAc,EAAE,KAAK,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACzE,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC"}

package/dist/metrics/index.js

@@ -0,0 +1,7 @@
+import { UsageCollector } from "./usage_collector.js";
+import { logMetrics } from "./utils.js";
+export {
+  UsageCollector,
+  logMetrics
+};
+//# sourceMappingURL=index.js.map

package/dist/metrics/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/metrics/index.ts"],"sourcesContent":["// SPDX-FileCopyrightText: 2024 LiveKit, Inc.\n//\n// SPDX-License-Identifier: Apache-2.0\n\nexport type {\n  AgentMetrics,\n  EOUMetrics,\n  LLMMetrics,\n  RealtimeModelMetrics,\n  STTMetrics,\n  TTSMetrics,\n  VADMetrics,\n} from './base.js';\nexport { UsageCollector, type UsageSummary } from './usage_collector.js';\nexport { logMetrics } from './utils.js';\n"],"mappings":"AAaA,SAAS,sBAAyC;AAClD,SAAS,kBAAkB;","names":[]}

package/dist/metrics/usage_collector.cjs

@@ -0,0 +1,58 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var usage_collector_exports = {};
+__export(usage_collector_exports, {
+  UsageCollector: () => UsageCollector
+});
+module.exports = __toCommonJS(usage_collector_exports);
+class UsageCollector {
+  summary;
+  constructor() {
+    this.summary = {
+      llmPromptTokens: 0,
+      llmPromptCachedTokens: 0,
+      llmCompletionTokens: 0,
+      ttsCharactersCount: 0,
+      sttAudioDurationMs: 0
+    };
+  }
+  collect(metrics) {
+    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.sttAudioDurationMs += metrics.audioDurationMs;
+    }
+  }
+  getSummary() {
+    return { ...this.summary };
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  UsageCollector
+});
+//# sourceMappingURL=usage_collector.cjs.map

package/dist/metrics/usage_collector.cjs.map

@@ -0,0 +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';\n\nexport interface UsageSummary {\n  llmPromptTokens: number;\n  llmPromptCachedTokens: number;\n  llmCompletionTokens: number;\n  ttsCharactersCount: number;\n  sttAudioDurationMs: 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      sttAudioDurationMs: 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.sttAudioDurationMs += metrics.audioDurationMs;\n    }\n  }\n\n  getSummary(): UsageSummary {\n    return { ...this.summary };\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;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,oBAAoB;AAAA,IACtB;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,sBAAsB,QAAQ;AAAA,IAC7C;AAAA,EACF;AAAA,EAEA,aAA2B;AACzB,WAAO,EAAE,GAAG,KAAK,QAAQ;AAAA,EAC3B;AACF;","names":[]}

package/dist/metrics/usage_collector.d.cts

@@ -0,0 +1,15 @@
+import type { AgentMetrics } from './base.js';
+export interface UsageSummary {
+    llmPromptTokens: number;
+    llmPromptCachedTokens: number;
+    llmCompletionTokens: number;
+    ttsCharactersCount: number;
+    sttAudioDurationMs: number;
+}
+export declare class UsageCollector {
+    private summary;
+    constructor();
+    collect(metrics: AgentMetrics): void;
+    getSummary(): UsageSummary;
+}
+//# sourceMappingURL=usage_collector.d.ts.map

package/dist/metrics/usage_collector.d.ts

@@ -0,0 +1,15 @@
+import type { AgentMetrics } from './base.js';
+export interface UsageSummary {
+    llmPromptTokens: number;
+    llmPromptCachedTokens: number;
+    llmCompletionTokens: number;
+    ttsCharactersCount: number;
+    sttAudioDurationMs: number;
+}
+export declare class UsageCollector {
+    private summary;
+    constructor();
+    collect(metrics: AgentMetrics): void;
+    getSummary(): UsageSummary;
+}
+//# sourceMappingURL=usage_collector.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"usage_collector.d.ts","sourceRoot":"","sources":["../../src/metrics/usage_collector.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAE9C,MAAM,WAAW,YAAY;IAC3B,eAAe,EAAE,MAAM,CAAC;IACxB,qBAAqB,EAAE,MAAM,CAAC;IAC9B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,kBAAkB,EAAE,MAAM,CAAC;CAC5B;AAED,qBAAa,cAAc;IACzB,OAAO,CAAC,OAAO,CAAe;;IAY9B,OAAO,CAAC,OAAO,EAAE,YAAY,GAAG,IAAI;IAgBpC,UAAU,IAAI,YAAY;CAG3B"}

package/dist/metrics/usage_collector.js

@@ -0,0 +1,34 @@
+class UsageCollector {
+  summary;
+  constructor() {
+    this.summary = {
+      llmPromptTokens: 0,
+      llmPromptCachedTokens: 0,
+      llmCompletionTokens: 0,
+      ttsCharactersCount: 0,
+      sttAudioDurationMs: 0
+    };
+  }
+  collect(metrics) {
+    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.sttAudioDurationMs += metrics.audioDurationMs;
+    }
+  }
+  getSummary() {
+    return { ...this.summary };
+  }
+}
+export {
+  UsageCollector
+};
+//# sourceMappingURL=usage_collector.js.map

package/dist/metrics/usage_collector.js.map

@@ -0,0 +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';\n\nexport interface UsageSummary {\n  llmPromptTokens: number;\n  llmPromptCachedTokens: number;\n  llmCompletionTokens: number;\n  ttsCharactersCount: number;\n  sttAudioDurationMs: 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      sttAudioDurationMs: 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.sttAudioDurationMs += metrics.audioDurationMs;\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,oBAAoB;AAAA,IACtB;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,sBAAsB,QAAQ;AAAA,IAC7C;AAAA,EACF;AAAA,EAEA,aAA2B;AACzB,WAAO,EAAE,GAAG,KAAK,QAAQ;AAAA,EAC3B;AACF;","names":[]}