@livekit/agents 0.0.0-20260120144724

package/dist/telemetry/trace_types.d.ts

@@ -0,0 +1,61 @@
+export declare const ATTR_SPEECH_ID = "lk.speech_id";
+export declare const ATTR_AGENT_LABEL = "lk.agent_label";
+export declare const ATTR_START_TIME = "lk.start_time";
+export declare const ATTR_END_TIME = "lk.end_time";
+export declare const ATTR_RETRY_COUNT = "lk.retry_count";
+export declare const ATTR_PARTICIPANT_ID = "lk.participant_id";
+export declare const ATTR_PARTICIPANT_IDENTITY = "lk.participant_identity";
+export declare const ATTR_PARTICIPANT_KIND = "lk.participant_kind";
+export declare const ATTR_JOB_ID = "lk.job_id";
+export declare const ATTR_AGENT_NAME = "lk.agent_name";
+export declare const ATTR_ROOM_NAME = "lk.room_name";
+export declare const ATTR_SESSION_OPTIONS = "lk.session_options";
+export declare const ATTR_USER_INPUT = "lk.user_input";
+export declare const ATTR_INSTRUCTIONS = "lk.instructions";
+export declare const ATTR_SPEECH_INTERRUPTED = "lk.interrupted";
+export declare const ATTR_CHAT_CTX = "lk.chat_ctx";
+export declare const ATTR_FUNCTION_TOOLS = "lk.function_tools";
+export declare const ATTR_RESPONSE_TEXT = "lk.response.text";
+export declare const ATTR_RESPONSE_FUNCTION_CALLS = "lk.response.function_calls";
+export declare const ATTR_FUNCTION_TOOL_NAME = "lk.function_tool.name";
+export declare const ATTR_FUNCTION_TOOL_ARGS = "lk.function_tool.arguments";
+export declare const ATTR_FUNCTION_TOOL_IS_ERROR = "lk.function_tool.is_error";
+export declare const ATTR_FUNCTION_TOOL_OUTPUT = "lk.function_tool.output";
+export declare const ATTR_TTS_INPUT_TEXT = "lk.input_text";
+export declare const ATTR_TTS_STREAMING = "lk.tts.streaming";
+export declare const ATTR_TTS_LABEL = "lk.tts.label";
+export declare const ATTR_EOU_PROBABILITY = "lk.eou.probability";
+export declare const ATTR_EOU_UNLIKELY_THRESHOLD = "lk.eou.unlikely_threshold";
+export declare const ATTR_EOU_DELAY = "lk.eou.endpointing_delay";
+export declare const ATTR_EOU_LANGUAGE = "lk.eou.language";
+export declare const ATTR_USER_TRANSCRIPT = "lk.user_transcript";
+export declare const ATTR_TRANSCRIPT_CONFIDENCE = "lk.transcript_confidence";
+export declare const ATTR_TRANSCRIPTION_DELAY = "lk.transcription_delay";
+export declare const ATTR_END_OF_TURN_DELAY = "lk.end_of_turn_delay";
+export declare const ATTR_IS_INTERRUPTION = "lk.is_interruption";
+export declare const ATTR_INTERRUPTION_PROBABILITY = "lk.interruption.probability";
+export declare const ATTR_INTERRUPTION_TOTAL_DURATION = "lk.interruption.total_duration";
+export declare const ATTR_INTERRUPTION_PREDICTION_DURATION = "lk.interruption.prediction_duration";
+export declare const ATTR_INTERRUPTION_DETECTION_DELAY = "lk.interruption.detection_delay";
+export declare const ATTR_LLM_METRICS = "lk.llm_metrics";
+export declare const ATTR_TTS_METRICS = "lk.tts_metrics";
+export declare const ATTR_REALTIME_MODEL_METRICS = "lk.realtime_model_metrics";
+export declare const ATTR_GEN_AI_OPERATION_NAME = "gen_ai.operation.name";
+export declare const ATTR_GEN_AI_REQUEST_MODEL = "gen_ai.request.model";
+export declare const ATTR_GEN_AI_USAGE_INPUT_TOKENS = "gen_ai.usage.input_tokens";
+export declare const ATTR_GEN_AI_USAGE_OUTPUT_TOKENS = "gen_ai.usage.output_tokens";
+export declare const ATTR_GEN_AI_USAGE_INPUT_TEXT_TOKENS = "gen_ai.usage.input_text_tokens";
+export declare const ATTR_GEN_AI_USAGE_INPUT_AUDIO_TOKENS = "gen_ai.usage.input_audio_tokens";
+export declare const ATTR_GEN_AI_USAGE_INPUT_CACHED_TOKENS = "gen_ai.usage.input_cached_tokens";
+export declare const ATTR_GEN_AI_USAGE_OUTPUT_TEXT_TOKENS = "gen_ai.usage.output_text_tokens";
+export declare const ATTR_GEN_AI_USAGE_OUTPUT_AUDIO_TOKENS = "gen_ai.usage.output_audio_tokens";
+export declare const EVENT_GEN_AI_SYSTEM_MESSAGE = "gen_ai.system.message";
+export declare const EVENT_GEN_AI_USER_MESSAGE = "gen_ai.user.message";
+export declare const EVENT_GEN_AI_ASSISTANT_MESSAGE = "gen_ai.assistant.message";
+export declare const EVENT_GEN_AI_TOOL_MESSAGE = "gen_ai.tool.message";
+export declare const EVENT_GEN_AI_CHOICE = "gen_ai.choice";
+export declare const ATTR_EXCEPTION_TRACE = "exception.stacktrace";
+export declare const ATTR_EXCEPTION_TYPE = "exception.type";
+export declare const ATTR_EXCEPTION_MESSAGE = "exception.message";
+export declare const ATTR_LANGFUSE_COMPLETION_START_TIME = "langfuse.observation.completion_start_time";
+//# sourceMappingURL=trace_types.d.ts.map

package/dist/telemetry/trace_types.d.ts.map

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

package/dist/telemetry/trace_types.js

@@ -0,0 +1,123 @@
+const ATTR_SPEECH_ID = "lk.speech_id";
+const ATTR_AGENT_LABEL = "lk.agent_label";
+const ATTR_START_TIME = "lk.start_time";
+const ATTR_END_TIME = "lk.end_time";
+const ATTR_RETRY_COUNT = "lk.retry_count";
+const ATTR_PARTICIPANT_ID = "lk.participant_id";
+const ATTR_PARTICIPANT_IDENTITY = "lk.participant_identity";
+const ATTR_PARTICIPANT_KIND = "lk.participant_kind";
+const ATTR_JOB_ID = "lk.job_id";
+const ATTR_AGENT_NAME = "lk.agent_name";
+const ATTR_ROOM_NAME = "lk.room_name";
+const ATTR_SESSION_OPTIONS = "lk.session_options";
+const ATTR_USER_INPUT = "lk.user_input";
+const ATTR_INSTRUCTIONS = "lk.instructions";
+const ATTR_SPEECH_INTERRUPTED = "lk.interrupted";
+const ATTR_CHAT_CTX = "lk.chat_ctx";
+const ATTR_FUNCTION_TOOLS = "lk.function_tools";
+const ATTR_RESPONSE_TEXT = "lk.response.text";
+const ATTR_RESPONSE_FUNCTION_CALLS = "lk.response.function_calls";
+const ATTR_FUNCTION_TOOL_NAME = "lk.function_tool.name";
+const ATTR_FUNCTION_TOOL_ARGS = "lk.function_tool.arguments";
+const ATTR_FUNCTION_TOOL_IS_ERROR = "lk.function_tool.is_error";
+const ATTR_FUNCTION_TOOL_OUTPUT = "lk.function_tool.output";
+const ATTR_TTS_INPUT_TEXT = "lk.input_text";
+const ATTR_TTS_STREAMING = "lk.tts.streaming";
+const ATTR_TTS_LABEL = "lk.tts.label";
+const ATTR_EOU_PROBABILITY = "lk.eou.probability";
+const ATTR_EOU_UNLIKELY_THRESHOLD = "lk.eou.unlikely_threshold";
+const ATTR_EOU_DELAY = "lk.eou.endpointing_delay";
+const ATTR_EOU_LANGUAGE = "lk.eou.language";
+const ATTR_USER_TRANSCRIPT = "lk.user_transcript";
+const ATTR_TRANSCRIPT_CONFIDENCE = "lk.transcript_confidence";
+const ATTR_TRANSCRIPTION_DELAY = "lk.transcription_delay";
+const ATTR_END_OF_TURN_DELAY = "lk.end_of_turn_delay";
+const ATTR_IS_INTERRUPTION = "lk.is_interruption";
+const ATTR_INTERRUPTION_PROBABILITY = "lk.interruption.probability";
+const ATTR_INTERRUPTION_TOTAL_DURATION = "lk.interruption.total_duration";
+const ATTR_INTERRUPTION_PREDICTION_DURATION = "lk.interruption.prediction_duration";
+const ATTR_INTERRUPTION_DETECTION_DELAY = "lk.interruption.detection_delay";
+const ATTR_LLM_METRICS = "lk.llm_metrics";
+const ATTR_TTS_METRICS = "lk.tts_metrics";
+const ATTR_REALTIME_MODEL_METRICS = "lk.realtime_model_metrics";
+const ATTR_GEN_AI_OPERATION_NAME = "gen_ai.operation.name";
+const ATTR_GEN_AI_REQUEST_MODEL = "gen_ai.request.model";
+const ATTR_GEN_AI_USAGE_INPUT_TOKENS = "gen_ai.usage.input_tokens";
+const ATTR_GEN_AI_USAGE_OUTPUT_TOKENS = "gen_ai.usage.output_tokens";
+const ATTR_GEN_AI_USAGE_INPUT_TEXT_TOKENS = "gen_ai.usage.input_text_tokens";
+const ATTR_GEN_AI_USAGE_INPUT_AUDIO_TOKENS = "gen_ai.usage.input_audio_tokens";
+const ATTR_GEN_AI_USAGE_INPUT_CACHED_TOKENS = "gen_ai.usage.input_cached_tokens";
+const ATTR_GEN_AI_USAGE_OUTPUT_TEXT_TOKENS = "gen_ai.usage.output_text_tokens";
+const ATTR_GEN_AI_USAGE_OUTPUT_AUDIO_TOKENS = "gen_ai.usage.output_audio_tokens";
+const EVENT_GEN_AI_SYSTEM_MESSAGE = "gen_ai.system.message";
+const EVENT_GEN_AI_USER_MESSAGE = "gen_ai.user.message";
+const EVENT_GEN_AI_ASSISTANT_MESSAGE = "gen_ai.assistant.message";
+const EVENT_GEN_AI_TOOL_MESSAGE = "gen_ai.tool.message";
+const EVENT_GEN_AI_CHOICE = "gen_ai.choice";
+const ATTR_EXCEPTION_TRACE = "exception.stacktrace";
+const ATTR_EXCEPTION_TYPE = "exception.type";
+const ATTR_EXCEPTION_MESSAGE = "exception.message";
+const ATTR_LANGFUSE_COMPLETION_START_TIME = "langfuse.observation.completion_start_time";
+export {
+  ATTR_AGENT_LABEL,
+  ATTR_AGENT_NAME,
+  ATTR_CHAT_CTX,
+  ATTR_END_OF_TURN_DELAY,
+  ATTR_END_TIME,
+  ATTR_EOU_DELAY,
+  ATTR_EOU_LANGUAGE,
+  ATTR_EOU_PROBABILITY,
+  ATTR_EOU_UNLIKELY_THRESHOLD,
+  ATTR_EXCEPTION_MESSAGE,
+  ATTR_EXCEPTION_TRACE,
+  ATTR_EXCEPTION_TYPE,
+  ATTR_FUNCTION_TOOLS,
+  ATTR_FUNCTION_TOOL_ARGS,
+  ATTR_FUNCTION_TOOL_IS_ERROR,
+  ATTR_FUNCTION_TOOL_NAME,
+  ATTR_FUNCTION_TOOL_OUTPUT,
+  ATTR_GEN_AI_OPERATION_NAME,
+  ATTR_GEN_AI_REQUEST_MODEL,
+  ATTR_GEN_AI_USAGE_INPUT_AUDIO_TOKENS,
+  ATTR_GEN_AI_USAGE_INPUT_CACHED_TOKENS,
+  ATTR_GEN_AI_USAGE_INPUT_TEXT_TOKENS,
+  ATTR_GEN_AI_USAGE_INPUT_TOKENS,
+  ATTR_GEN_AI_USAGE_OUTPUT_AUDIO_TOKENS,
+  ATTR_GEN_AI_USAGE_OUTPUT_TEXT_TOKENS,
+  ATTR_GEN_AI_USAGE_OUTPUT_TOKENS,
+  ATTR_INSTRUCTIONS,
+  ATTR_INTERRUPTION_DETECTION_DELAY,
+  ATTR_INTERRUPTION_PREDICTION_DURATION,
+  ATTR_INTERRUPTION_PROBABILITY,
+  ATTR_INTERRUPTION_TOTAL_DURATION,
+  ATTR_IS_INTERRUPTION,
+  ATTR_JOB_ID,
+  ATTR_LANGFUSE_COMPLETION_START_TIME,
+  ATTR_LLM_METRICS,
+  ATTR_PARTICIPANT_ID,
+  ATTR_PARTICIPANT_IDENTITY,
+  ATTR_PARTICIPANT_KIND,
+  ATTR_REALTIME_MODEL_METRICS,
+  ATTR_RESPONSE_FUNCTION_CALLS,
+  ATTR_RESPONSE_TEXT,
+  ATTR_RETRY_COUNT,
+  ATTR_ROOM_NAME,
+  ATTR_SESSION_OPTIONS,
+  ATTR_SPEECH_ID,
+  ATTR_SPEECH_INTERRUPTED,
+  ATTR_START_TIME,
+  ATTR_TRANSCRIPTION_DELAY,
+  ATTR_TRANSCRIPT_CONFIDENCE,
+  ATTR_TTS_INPUT_TEXT,
+  ATTR_TTS_LABEL,
+  ATTR_TTS_METRICS,
+  ATTR_TTS_STREAMING,
+  ATTR_USER_INPUT,
+  ATTR_USER_TRANSCRIPT,
+  EVENT_GEN_AI_ASSISTANT_MESSAGE,
+  EVENT_GEN_AI_CHOICE,
+  EVENT_GEN_AI_SYSTEM_MESSAGE,
+  EVENT_GEN_AI_TOOL_MESSAGE,
+  EVENT_GEN_AI_USER_MESSAGE
+};
+//# sourceMappingURL=trace_types.js.map

package/dist/telemetry/trace_types.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/telemetry/trace_types.ts"],"sourcesContent":["// SPDX-FileCopyrightText: 2025 LiveKit, Inc.\n//\n// SPDX-License-Identifier: Apache-2.0\n\n// LiveKit custom attributes\nexport const ATTR_SPEECH_ID = 'lk.speech_id';\nexport const ATTR_AGENT_LABEL = 'lk.agent_label';\nexport const ATTR_START_TIME = 'lk.start_time';\nexport const ATTR_END_TIME = 'lk.end_time';\nexport const ATTR_RETRY_COUNT = 'lk.retry_count';\n\nexport const ATTR_PARTICIPANT_ID = 'lk.participant_id';\nexport const ATTR_PARTICIPANT_IDENTITY = 'lk.participant_identity';\nexport const ATTR_PARTICIPANT_KIND = 'lk.participant_kind';\n\n// session start\nexport const ATTR_JOB_ID = 'lk.job_id';\nexport const ATTR_AGENT_NAME = 'lk.agent_name';\nexport const ATTR_ROOM_NAME = 'lk.room_name';\nexport const ATTR_SESSION_OPTIONS = 'lk.session_options';\n\n// assistant turn\nexport const ATTR_USER_INPUT = 'lk.user_input';\nexport const ATTR_INSTRUCTIONS = 'lk.instructions';\nexport const ATTR_SPEECH_INTERRUPTED = 'lk.interrupted';\n\n// llm node\nexport const ATTR_CHAT_CTX = 'lk.chat_ctx';\nexport const ATTR_FUNCTION_TOOLS = 'lk.function_tools';\nexport const ATTR_RESPONSE_TEXT = 'lk.response.text';\nexport const ATTR_RESPONSE_FUNCTION_CALLS = 'lk.response.function_calls';\n\n// function tool\nexport const ATTR_FUNCTION_TOOL_NAME = 'lk.function_tool.name';\nexport const ATTR_FUNCTION_TOOL_ARGS = 'lk.function_tool.arguments';\nexport const ATTR_FUNCTION_TOOL_IS_ERROR = 'lk.function_tool.is_error';\nexport const ATTR_FUNCTION_TOOL_OUTPUT = 'lk.function_tool.output';\n\n// tts node\nexport const ATTR_TTS_INPUT_TEXT = 'lk.input_text';\nexport const ATTR_TTS_STREAMING = 'lk.tts.streaming';\nexport const ATTR_TTS_LABEL = 'lk.tts.label';\n\n// eou detection\nexport const ATTR_EOU_PROBABILITY = 'lk.eou.probability';\nexport const ATTR_EOU_UNLIKELY_THRESHOLD = 'lk.eou.unlikely_threshold';\nexport const ATTR_EOU_DELAY = 'lk.eou.endpointing_delay';\nexport const ATTR_EOU_LANGUAGE = 'lk.eou.language';\nexport const ATTR_USER_TRANSCRIPT = 'lk.user_transcript';\nexport const ATTR_TRANSCRIPT_CONFIDENCE = 'lk.transcript_confidence';\nexport const ATTR_TRANSCRIPTION_DELAY = 'lk.transcription_delay';\nexport const ATTR_END_OF_TURN_DELAY = 'lk.end_of_turn_delay';\n\n// Adaptive Interruption attributes\nexport const ATTR_IS_INTERRUPTION = 'lk.is_interruption';\nexport const ATTR_INTERRUPTION_PROBABILITY = 'lk.interruption.probability';\nexport const ATTR_INTERRUPTION_TOTAL_DURATION = 'lk.interruption.total_duration';\nexport const ATTR_INTERRUPTION_PREDICTION_DURATION = 'lk.interruption.prediction_duration';\nexport const ATTR_INTERRUPTION_DETECTION_DELAY = 'lk.interruption.detection_delay';\n\n// metrics\nexport const ATTR_LLM_METRICS = 'lk.llm_metrics';\nexport const ATTR_TTS_METRICS = 'lk.tts_metrics';\nexport const ATTR_REALTIME_MODEL_METRICS = 'lk.realtime_model_metrics';\n\n// OpenTelemetry GenAI attributes\n// OpenTelemetry specification: https://opentelemetry.io/docs/specs/semconv/registry/attributes/gen-ai/\nexport const ATTR_GEN_AI_OPERATION_NAME = 'gen_ai.operation.name';\nexport const ATTR_GEN_AI_REQUEST_MODEL = 'gen_ai.request.model';\nexport const ATTR_GEN_AI_USAGE_INPUT_TOKENS = 'gen_ai.usage.input_tokens';\nexport const ATTR_GEN_AI_USAGE_OUTPUT_TOKENS = 'gen_ai.usage.output_tokens';\n\n// Unofficial OpenTelemetry GenAI attributes, recognized by LangFuse\n// https://langfuse.com/integrations/native/opentelemetry#usage\n// but not yet in the official OpenTelemetry specification.\nexport const ATTR_GEN_AI_USAGE_INPUT_TEXT_TOKENS = 'gen_ai.usage.input_text_tokens';\nexport const ATTR_GEN_AI_USAGE_INPUT_AUDIO_TOKENS = 'gen_ai.usage.input_audio_tokens';\nexport const ATTR_GEN_AI_USAGE_INPUT_CACHED_TOKENS = 'gen_ai.usage.input_cached_tokens';\nexport const ATTR_GEN_AI_USAGE_OUTPUT_TEXT_TOKENS = 'gen_ai.usage.output_text_tokens';\nexport const ATTR_GEN_AI_USAGE_OUTPUT_AUDIO_TOKENS = 'gen_ai.usage.output_audio_tokens';\n\n// OpenTelemetry GenAI event names (for structured logging)\nexport const EVENT_GEN_AI_SYSTEM_MESSAGE = 'gen_ai.system.message';\nexport const EVENT_GEN_AI_USER_MESSAGE = 'gen_ai.user.message';\nexport const EVENT_GEN_AI_ASSISTANT_MESSAGE = 'gen_ai.assistant.message';\nexport const EVENT_GEN_AI_TOOL_MESSAGE = 'gen_ai.tool.message';\nexport const EVENT_GEN_AI_CHOICE = 'gen_ai.choice';\n\n// Exception attributes\nexport const ATTR_EXCEPTION_TRACE = 'exception.stacktrace';\nexport const ATTR_EXCEPTION_TYPE = 'exception.type';\nexport const ATTR_EXCEPTION_MESSAGE = 'exception.message';\n\n// Platform-specific attributes\nexport const ATTR_LANGFUSE_COMPLETION_START_TIME = 'langfuse.observation.completion_start_time';\n"],"mappings":"AAKO,MAAM,iBAAiB;AACvB,MAAM,mBAAmB;AACzB,MAAM,kBAAkB;AACxB,MAAM,gBAAgB;AACtB,MAAM,mBAAmB;AAEzB,MAAM,sBAAsB;AAC5B,MAAM,4BAA4B;AAClC,MAAM,wBAAwB;AAG9B,MAAM,cAAc;AACpB,MAAM,kBAAkB;AACxB,MAAM,iBAAiB;AACvB,MAAM,uBAAuB;AAG7B,MAAM,kBAAkB;AACxB,MAAM,oBAAoB;AAC1B,MAAM,0BAA0B;AAGhC,MAAM,gBAAgB;AACtB,MAAM,sBAAsB;AAC5B,MAAM,qBAAqB;AAC3B,MAAM,+BAA+B;AAGrC,MAAM,0BAA0B;AAChC,MAAM,0BAA0B;AAChC,MAAM,8BAA8B;AACpC,MAAM,4BAA4B;AAGlC,MAAM,sBAAsB;AAC5B,MAAM,qBAAqB;AAC3B,MAAM,iBAAiB;AAGvB,MAAM,uBAAuB;AAC7B,MAAM,8BAA8B;AACpC,MAAM,iBAAiB;AACvB,MAAM,oBAAoB;AAC1B,MAAM,uBAAuB;AAC7B,MAAM,6BAA6B;AACnC,MAAM,2BAA2B;AACjC,MAAM,yBAAyB;AAG/B,MAAM,uBAAuB;AAC7B,MAAM,gCAAgC;AACtC,MAAM,mCAAmC;AACzC,MAAM,wCAAwC;AAC9C,MAAM,oCAAoC;AAG1C,MAAM,mBAAmB;AACzB,MAAM,mBAAmB;AACzB,MAAM,8BAA8B;AAIpC,MAAM,6BAA6B;AACnC,MAAM,4BAA4B;AAClC,MAAM,iCAAiC;AACvC,MAAM,kCAAkC;AAKxC,MAAM,sCAAsC;AAC5C,MAAM,uCAAuC;AAC7C,MAAM,wCAAwC;AAC9C,MAAM,uCAAuC;AAC7C,MAAM,wCAAwC;AAG9C,MAAM,8BAA8B;AACpC,MAAM,4BAA4B;AAClC,MAAM,iCAAiC;AACvC,MAAM,4BAA4B;AAClC,MAAM,sBAAsB;AAG5B,MAAM,uBAAuB;AAC7B,MAAM,sBAAsB;AAC5B,MAAM,yBAAyB;AAG/B,MAAM,sCAAsC;","names":[]}

package/dist/telemetry/traces.cjs

@@ -0,0 +1,444 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+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 __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var traces_exports = {};
+__export(traces_exports, {
+  flushOtelLogs: () => flushOtelLogs,
+  setTracerProvider: () => setTracerProvider,
+  setupCloudTracer: () => setupCloudTracer,
+  tracer: () => tracer,
+  uploadSessionReport: () => uploadSessionReport
+});
+module.exports = __toCommonJS(traces_exports);
+var import_protocol = require("@livekit/protocol");
+var import_api = require("@opentelemetry/api");
+var import_api_logs = require("@opentelemetry/api-logs");
+var import_exporter_trace_otlp_proto = require("@opentelemetry/exporter-trace-otlp-proto");
+var import_otlp_exporter_base = require("@opentelemetry/otlp-exporter-base");
+var import_resources = require("@opentelemetry/resources");
+var import_sdk_trace_node = require("@opentelemetry/sdk-trace-node");
+var import_semantic_conventions = require("@opentelemetry/semantic-conventions");
+var import_form_data = __toESM(require("form-data"), 1);
+var import_livekit_server_sdk = require("livekit-server-sdk");
+var import_promises = __toESM(require("node:fs/promises"), 1);
+var import_log = require("../log.cjs");
+var import_otel_http_exporter = require("./otel_http_exporter.cjs");
+var import_pino_otel_transport = require("./pino_otel_transport.cjs");
+class DynamicTracer {
+  tracerProvider;
+  tracer;
+  instrumentingModuleName;
+  constructor(instrumentingModuleName) {
+    this.instrumentingModuleName = instrumentingModuleName;
+    this.tracerProvider = import_api.trace.getTracerProvider();
+    this.tracer = import_api.trace.getTracer(instrumentingModuleName);
+  }
+  /**
+   * Set a new tracer provider. This updates the underlying tracer instance.
+   * @param provider - The new tracer provider to use
+   */
+  setProvider(provider) {
+    this.tracerProvider = provider;
+    this.tracer = this.tracerProvider.getTracer(this.instrumentingModuleName);
+  }
+  /**
+   * Get the underlying OpenTelemetry tracer.
+   * Use this to access the full Tracer API when needed.
+   */
+  getTracer() {
+    return this.tracer;
+  }
+  /**
+   * Start a span manually (without making it active).
+   * You must call span.end() when done.
+   *
+   * @param options - Span configuration including name
+   * @returns The created span
+   */
+  startSpan(options) {
+    const ctx = options.context || import_api.context.active();
+    const span = this.tracer.startSpan(
+      options.name,
+      {
+        attributes: options.attributes
+      },
+      ctx
+    );
+    return span;
+  }
+  /**
+   * Start a new span and make it active in the current context.
+   * The span will automatically be ended when the provided function completes (unless endOnExit=false).
+   *
+   * @param fn - The function to execute within the span context
+   * @param options - Span configuration including name
+   * @returns The result of the provided function
+   */
+  async startActiveSpan(fn, options) {
+    const ctx = options.context || import_api.context.active();
+    const endOnExit = options.endOnExit === void 0 ? true : options.endOnExit;
+    const opts = { attributes: options.attributes };
+    return await this.tracer.startActiveSpan(options.name, opts, ctx, async (span) => {
+      try {
+        return await fn(span);
+      } finally {
+        if (endOnExit) {
+          span.end();
+        }
+      }
+    });
+  }
+  /**
+   * Synchronous version of startActiveSpan for non-async operations.
+   *
+   * @param fn - The function to execute within the span context
+   * @param options - Span configuration including name
+   * @returns The result of the provided function
+   */
+  startActiveSpanSync(fn, options) {
+    const ctx = options.context || import_api.context.active();
+    const endOnExit = options.endOnExit === void 0 ? true : options.endOnExit;
+    const opts = { attributes: options.attributes };
+    return this.tracer.startActiveSpan(options.name, opts, ctx, (span) => {
+      try {
+        return fn(span);
+      } finally {
+        if (endOnExit) {
+          span.end();
+        }
+      }
+    });
+  }
+}
+const tracer = new DynamicTracer("livekit-agents");
+class MetadataSpanProcessor {
+  metadata;
+  constructor(metadata) {
+    this.metadata = metadata;
+  }
+  onStart(span, _parentContext) {
+    span.setAttributes(this.metadata);
+  }
+  onEnd(_span) {
+  }
+  shutdown() {
+    return Promise.resolve();
+  }
+  forceFlush() {
+    return Promise.resolve();
+  }
+}
+function setTracerProvider(provider, options) {
+  if (options == null ? void 0 : options.metadata) {
+    provider.addSpanProcessor(new MetadataSpanProcessor(options.metadata));
+  }
+  tracer.setProvider(provider);
+}
+async function setupCloudTracer(options) {
+  const { roomId, jobId, cloudHostname } = options;
+  const apiKey = process.env.LIVEKIT_API_KEY;
+  const apiSecret = process.env.LIVEKIT_API_SECRET;
+  if (!apiKey || !apiSecret) {
+    throw new Error("LIVEKIT_API_KEY and LIVEKIT_API_SECRET must be set for cloud tracing");
+  }
+  const token = new import_livekit_server_sdk.AccessToken(apiKey, apiSecret, {
+    identity: "livekit-agents-telemetry",
+    ttl: "6h"
+  });
+  token.addObservabilityGrant({ write: true });
+  try {
+    const jwt = await token.toJwt();
+    const headers = {
+      Authorization: `Bearer ${jwt}`
+    };
+    const metadata = {
+      room_id: roomId,
+      job_id: jobId
+    };
+    const resource = new import_resources.Resource({
+      [import_semantic_conventions.ATTR_SERVICE_NAME]: "livekit-agents",
+      room_id: roomId,
+      job_id: jobId
+    });
+    const spanExporter = new import_exporter_trace_otlp_proto.OTLPTraceExporter({
+      url: `https://${cloudHostname}/observability/traces/otlp/v0`,
+      headers,
+      compression: import_otlp_exporter_base.CompressionAlgorithm.GZIP
+    });
+    const tracerProvider = new import_sdk_trace_node.NodeTracerProvider({
+      resource,
+      spanProcessors: [new MetadataSpanProcessor(metadata), new import_sdk_trace_node.BatchSpanProcessor(spanExporter)]
+    });
+    tracerProvider.register();
+    setTracerProvider(tracerProvider);
+    (0, import_pino_otel_transport.initPinoCloudExporter)({
+      cloudHostname,
+      roomId,
+      jobId
+    });
+    (0, import_log.enableOtelLogging)();
+  } catch (error) {
+    console.error("Failed to setup cloud tracer:", error);
+    throw error;
+  }
+}
+async function flushOtelLogs() {
+  await (0, import_pino_otel_transport.flushPinoLogs)();
+}
+function chatItemToProto(item) {
+  var _a, _b;
+  const itemDict = {};
+  if (item.type === "message") {
+    const roleMap = {
+      developer: "DEVELOPER",
+      system: "SYSTEM",
+      user: "USER",
+      assistant: "ASSISTANT"
+    };
+    const msg = {
+      id: item.id,
+      role: roleMap[item.role] || item.role.toUpperCase(),
+      content: item.content.map((c) => ({ text: c })),
+      createdAt: toRFC3339(item.createdAt)
+    };
+    if (item.interrupted) {
+      msg.interrupted = item.interrupted;
+    }
+    itemDict.message = msg;
+  } else if (item.type === "function_call") {
+    itemDict.functionCall = {
+      id: item.id,
+      callId: item.callId,
+      arguments: item.args,
+      name: item.name,
+      createdAt: toRFC3339(item.createdAt)
+    };
+  } else if (item.type === "function_call_output") {
+    itemDict.functionCallOutput = {
+      id: item.id,
+      name: item.name,
+      callId: item.callId,
+      output: item.output,
+      isError: item.isError,
+      createdAt: toRFC3339(item.createdAt)
+    };
+  } else if (item.type === "agent_handoff") {
+    const handoff = {
+      id: item.id,
+      newAgentId: item.newAgentId,
+      createdAt: toRFC3339(item.createdAt)
+    };
+    if (item.oldAgentId !== void 0 && item.oldAgentId !== null && item.oldAgentId !== "") {
+      handoff.oldAgentId = item.oldAgentId;
+    }
+    itemDict.agentHandoff = handoff;
+  }
+  try {
+    if (item.type === "function_call" && typeof ((_a = itemDict.functionCall) == null ? void 0 : _a.arguments) === "string") {
+      itemDict.functionCall.arguments = JSON.parse(itemDict.functionCall.arguments);
+    } else if (item.type === "function_call_output" && typeof ((_b = itemDict.functionCallOutput) == null ? void 0 : _b.output) === "string") {
+      itemDict.functionCallOutput.output = JSON.parse(itemDict.functionCallOutput.output);
+    }
+  } catch {
+  }
+  return itemDict;
+}
+function toRFC3339(valueMs) {
+  const dt = valueMs instanceof Date ? valueMs : new Date(valueMs);
+  const truncated = new Date(Math.floor(dt.getTime()));
+  return truncated.toISOString();
+}
+async function uploadSessionReport(options) {
+  const { agentName, cloudHostname, report } = options;
+  const logExporter = new import_otel_http_exporter.SimpleOTLPHttpLogExporter({
+    cloudHostname,
+    resourceAttributes: {
+      room_id: report.roomId,
+      job_id: report.jobId
+    },
+    scopeName: "chat_history",
+    scopeAttributes: {
+      room_id: report.roomId,
+      job_id: report.jobId,
+      room: report.room
+    }
+  });
+  const logRecords = [];
+  const commonAttrs = {
+    room_id: report.roomId,
+    job_id: report.jobId,
+    "logger.name": "chat_history"
+  };
+  logRecords.push({
+    body: "session report",
+    timestampMs: report.startedAt || report.timestamp || 0,
+    attributes: {
+      ...commonAttrs,
+      "session.options": report.options || {},
+      "session.report_timestamp": report.timestamp,
+      agent_name: agentName
+    }
+  });
+  let lastTimestamp = 0;
+  for (const item of report.chatHistory.items) {
+    if (!item) continue;
+    const hasValidTimestamp = Number.isFinite(item.createdAt);
+    let itemTimestamp = hasValidTimestamp ? item.createdAt : Date.now();
+    if (itemTimestamp <= lastTimestamp) {
+      itemTimestamp = lastTimestamp + 1e-3;
+    }
+    lastTimestamp = itemTimestamp;
+    const itemProto = chatItemToProto(item);
+    let severityNumber = import_api_logs.SeverityNumber.UNSPECIFIED;
+    let severityText = "unspecified";
+    if (item.type === "function_call_output" && item.isError) {
+      severityNumber = import_api_logs.SeverityNumber.ERROR;
+      severityText = "error";
+    }
+    logRecords.push({
+      body: "chat item",
+      timestampMs: itemTimestamp,
+      // Adjusted for monotonic ordering
+      attributes: { "chat.item": itemProto, ...commonAttrs },
+      severityNumber,
+      severityText
+    });
+  }
+  await logExporter.export(logRecords);
+  const apiKey = process.env.LIVEKIT_API_KEY;
+  const apiSecret = process.env.LIVEKIT_API_SECRET;
+  if (!apiKey || !apiSecret) {
+    throw new Error("LIVEKIT_API_KEY and LIVEKIT_API_SECRET must be set for session upload");
+  }
+  const token = new import_livekit_server_sdk.AccessToken(apiKey, apiSecret, { ttl: "6h" });
+  token.addObservabilityGrant({ write: true });
+  const jwt = await token.toJwt();
+  const formData = new import_form_data.default();
+  const audioStartTime = report.audioRecordingStartedAt ?? 0;
+  const headerMsg = new import_protocol.MetricsRecordingHeader({
+    roomId: report.roomId,
+    duration: BigInt(0),
+    // TODO: Calculate actual duration from report
+    startTime: {
+      seconds: BigInt(Math.floor(audioStartTime / 1e3)),
+      nanos: Math.floor(audioStartTime % 1e3 * 1e6)
+    }
+  });
+  const headerBytes = Buffer.from(headerMsg.toBinary());
+  formData.append("header", headerBytes, {
+    filename: "header.binpb",
+    contentType: "application/protobuf",
+    knownLength: headerBytes.length,
+    header: {
+      "Content-Type": "application/protobuf",
+      "Content-Length": headerBytes.length.toString()
+    }
+  });
+  const chatHistoryJson = JSON.stringify(report.chatHistory.toJSON({ excludeTimestamp: false }));
+  const chatHistoryBuffer = Buffer.from(chatHistoryJson, "utf-8");
+  formData.append("chat_history", chatHistoryBuffer, {
+    filename: "chat_history.json",
+    contentType: "application/json",
+    knownLength: chatHistoryBuffer.length,
+    header: {
+      "Content-Type": "application/json",
+      "Content-Length": chatHistoryBuffer.length.toString()
+    }
+  });
+  if (report.audioRecordingPath && report.audioRecordingStartedAt) {
+    let audioBytes;
+    try {
+      audioBytes = await import_promises.default.readFile(report.audioRecordingPath);
+    } catch {
+      audioBytes = Buffer.alloc(0);
+    }
+    if (audioBytes.length > 0) {
+      formData.append("audio", audioBytes, {
+        filename: "recording.ogg",
+        contentType: "audio/ogg",
+        knownLength: audioBytes.length,
+        header: {
+          "Content-Type": "audio/ogg",
+          "Content-Length": audioBytes.length.toString()
+        }
+      });
+    }
+  }
+  return new Promise((resolve, reject) => {
+    formData.submit(
+      {
+        protocol: "https:",
+        host: cloudHostname,
+        path: "/observability/recordings/v0",
+        method: "POST",
+        headers: {
+          Authorization: `Bearer ${jwt}`
+        }
+      },
+      (err, res) => {
+        if (err) {
+          reject(new Error(`Failed to upload session report: ${err.message}`));
+          return;
+        }
+        if (res.statusCode && res.statusCode >= 400) {
+          let body = "";
+          res.on("data", (chunk) => {
+            body += chunk.toString();
+          });
+          res.on("error", (readErr) => {
+            reject(
+              new Error(
+                `Failed to upload session report: ${res.statusCode} ${res.statusMessage} (body read error: ${readErr.message})`
+              )
+            );
+          });
+          res.on("end", () => {
+            reject(
+              new Error(
+                `Failed to upload session report: ${res.statusCode} ${res.statusMessage} - ${body}`
+              )
+            );
+          });
+          return;
+        }
+        res.resume();
+        res.on("error", (readErr) => reject(new Error(`Response read error: ${readErr.message}`)));
+        res.on("end", () => resolve());
+      }
+    );
+  });
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  flushOtelLogs,
+  setTracerProvider,
+  setupCloudTracer,
+  tracer,
+  uploadSessionReport
+});
+//# sourceMappingURL=traces.cjs.map