@livekit/agents 1.0.48 → 1.1.0-dev.0

package/dist/telemetry/trace_types.cjs

@@ -130,6 +130,11 @@ 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";
@@ -153,11 +158,6 @@ 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";
-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";
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   ATTR_AGENT_LABEL,

package/dist/telemetry/trace_types.cjs.map

@@ -1 +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_AGENT_TURN_ID = 'lk.generation_id';\nexport const ATTR_AGENT_PARENT_TURN_ID = 'lk.parent_generation_id';\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_PROVIDER_TOOLS = 'lk.provider_tools';\nexport const ATTR_TOOL_SETS = 'lk.tool_sets';\nexport const ATTR_RESPONSE_TEXT = 'lk.response.text';\nexport const ATTR_RESPONSE_FUNCTION_CALLS = 'lk.response.function_calls';\nexport const ATTR_RESPONSE_TTFT = 'lk.response.ttft';\n\n// function tool\nexport const ATTR_FUNCTION_TOOL_ID = 'lk.function_tool.id';\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';\nexport const ATTR_RESPONSE_TTFB = 'lk.response.ttfb';\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// 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// latency span attributes\nexport const ATTR_E2E_LATENCY = 'lk.e2e_latency';\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_PROVIDER_NAME = 'gen_ai.provider.name';\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\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"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;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,qBAAqB;AAC3B,MAAM,4BAA4B;AAClC,MAAM,kBAAkB;AACxB,MAAM,oBAAoB;AAC1B,MAAM,0BAA0B;AAGhC,MAAM,gBAAgB;AACtB,MAAM,sBAAsB;AAC5B,MAAM,sBAAsB;AAC5B,MAAM,iBAAiB;AACvB,MAAM,qBAAqB;AAC3B,MAAM,+BAA+B;AACrC,MAAM,qBAAqB;AAG3B,MAAM,wBAAwB;AAC9B,MAAM,0BAA0B;AAChC,MAAM,0BAA0B;AAChC,MAAM,8BAA8B;AACpC,MAAM,4BAA4B;AAGlC,MAAM,sBAAsB;AAC5B,MAAM,qBAAqB;AAC3B,MAAM,iBAAiB;AACvB,MAAM,qBAAqB;AAG3B,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,mBAAmB;AACzB,MAAM,mBAAmB;AACzB,MAAM,8BAA8B;AAGpC,MAAM,mBAAmB;AAIzB,MAAM,6BAA6B;AACnC,MAAM,4BAA4B;AAClC,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;AAG5C,MAAM,uBAAuB;AAC7B,MAAM,gCAAgC;AACtC,MAAM,mCAAmC;AACzC,MAAM,wCAAwC;AAC9C,MAAM,oCAAoC;","names":[]}
+{"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_AGENT_TURN_ID = 'lk.generation_id';\nexport const ATTR_AGENT_PARENT_TURN_ID = 'lk.parent_generation_id';\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_PROVIDER_TOOLS = 'lk.provider_tools';\nexport const ATTR_TOOL_SETS = 'lk.tool_sets';\nexport const ATTR_RESPONSE_TEXT = 'lk.response.text';\nexport const ATTR_RESPONSE_FUNCTION_CALLS = 'lk.response.function_calls';\n/** Time to first token in seconds. */\nexport const ATTR_RESPONSE_TTFT = 'lk.response.ttft';\n\n// function tool\nexport const ATTR_FUNCTION_TOOL_ID = 'lk.function_tool.id';\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/** Time to first byte in seconds. */\nexport const ATTR_RESPONSE_TTFB = 'lk.response.ttfb';\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/** End-to-end latency in seconds. */\nexport const ATTR_E2E_LATENCY = 'lk.e2e_latency';\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';\n/** The provider name (e.g., 'openai', 'anthropic'). */\nexport const ATTR_GEN_AI_PROVIDER_NAME = 'gen_ai.provider.name';\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":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;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,qBAAqB;AAC3B,MAAM,4BAA4B;AAClC,MAAM,kBAAkB;AACxB,MAAM,oBAAoB;AAC1B,MAAM,0BAA0B;AAGhC,MAAM,gBAAgB;AACtB,MAAM,sBAAsB;AAC5B,MAAM,sBAAsB;AAC5B,MAAM,iBAAiB;AACvB,MAAM,qBAAqB;AAC3B,MAAM,+BAA+B;AAErC,MAAM,qBAAqB;AAG3B,MAAM,wBAAwB;AAC9B,MAAM,0BAA0B;AAChC,MAAM,0BAA0B;AAChC,MAAM,8BAA8B;AACpC,MAAM,4BAA4B;AAGlC,MAAM,sBAAsB;AAC5B,MAAM,qBAAqB;AAC3B,MAAM,iBAAiB;AAEvB,MAAM,qBAAqB;AAG3B,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;AAGpC,MAAM,mBAAmB;AAIzB,MAAM,6BAA6B;AACnC,MAAM,4BAA4B;AAElC,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/trace_types.d.cts

@@ -21,6 +21,7 @@ export declare const ATTR_PROVIDER_TOOLS = "lk.provider_tools";
 export declare const ATTR_TOOL_SETS = "lk.tool_sets";
 export declare const ATTR_RESPONSE_TEXT = "lk.response.text";
 export declare const ATTR_RESPONSE_FUNCTION_CALLS = "lk.response.function_calls";
+/** Time to first token in seconds. */
 export declare const ATTR_RESPONSE_TTFT = "lk.response.ttft";
 export declare const ATTR_FUNCTION_TOOL_ID = "lk.function_tool.id";
 export declare const ATTR_FUNCTION_TOOL_NAME = "lk.function_tool.name";
@@ -30,6 +31,7 @@ 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";
+/** Time to first byte in seconds. */
 export declare const ATTR_RESPONSE_TTFB = "lk.response.ttfb";
 export declare const ATTR_EOU_PROBABILITY = "lk.eou.probability";
 export declare const ATTR_EOU_UNLIKELY_THRESHOLD = "lk.eou.unlikely_threshold";
@@ -39,12 +41,19 @@ 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";
+/** End-to-end latency in seconds. */
 export declare const ATTR_E2E_LATENCY = "lk.e2e_latency";
 export declare const ATTR_GEN_AI_OPERATION_NAME = "gen_ai.operation.name";
 export declare const ATTR_GEN_AI_REQUEST_MODEL = "gen_ai.request.model";
+/** The provider name (e.g., 'openai', 'anthropic'). */
 export declare const ATTR_GEN_AI_PROVIDER_NAME = "gen_ai.provider.name";
 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";
@@ -62,9 +71,4 @@ 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";
-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";
 //# sourceMappingURL=trace_types.d.ts.map

package/dist/telemetry/trace_types.d.ts

@@ -21,6 +21,7 @@ export declare const ATTR_PROVIDER_TOOLS = "lk.provider_tools";
 export declare const ATTR_TOOL_SETS = "lk.tool_sets";
 export declare const ATTR_RESPONSE_TEXT = "lk.response.text";
 export declare const ATTR_RESPONSE_FUNCTION_CALLS = "lk.response.function_calls";
+/** Time to first token in seconds. */
 export declare const ATTR_RESPONSE_TTFT = "lk.response.ttft";
 export declare const ATTR_FUNCTION_TOOL_ID = "lk.function_tool.id";
 export declare const ATTR_FUNCTION_TOOL_NAME = "lk.function_tool.name";
@@ -30,6 +31,7 @@ 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";
+/** Time to first byte in seconds. */
 export declare const ATTR_RESPONSE_TTFB = "lk.response.ttfb";
 export declare const ATTR_EOU_PROBABILITY = "lk.eou.probability";
 export declare const ATTR_EOU_UNLIKELY_THRESHOLD = "lk.eou.unlikely_threshold";
@@ -39,12 +41,19 @@ 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";
+/** End-to-end latency in seconds. */
 export declare const ATTR_E2E_LATENCY = "lk.e2e_latency";
 export declare const ATTR_GEN_AI_OPERATION_NAME = "gen_ai.operation.name";
 export declare const ATTR_GEN_AI_REQUEST_MODEL = "gen_ai.request.model";
+/** The provider name (e.g., 'openai', 'anthropic'). */
 export declare const ATTR_GEN_AI_PROVIDER_NAME = "gen_ai.provider.name";
 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";
@@ -62,9 +71,4 @@ 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";
-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";
 //# sourceMappingURL=trace_types.d.ts.map

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

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

@@ -39,6 +39,11 @@ 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";
@@ -62,11 +67,6 @@ 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";
-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";
 export {
   ATTR_AGENT_LABEL,
   ATTR_AGENT_NAME,

package/dist/telemetry/trace_types.js.map

@@ -1 +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_AGENT_TURN_ID = 'lk.generation_id';\nexport const ATTR_AGENT_PARENT_TURN_ID = 'lk.parent_generation_id';\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_PROVIDER_TOOLS = 'lk.provider_tools';\nexport const ATTR_TOOL_SETS = 'lk.tool_sets';\nexport const ATTR_RESPONSE_TEXT = 'lk.response.text';\nexport const ATTR_RESPONSE_FUNCTION_CALLS = 'lk.response.function_calls';\nexport const ATTR_RESPONSE_TTFT = 'lk.response.ttft';\n\n// function tool\nexport const ATTR_FUNCTION_TOOL_ID = 'lk.function_tool.id';\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';\nexport const ATTR_RESPONSE_TTFB = 'lk.response.ttfb';\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// 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// latency span attributes\nexport const ATTR_E2E_LATENCY = 'lk.e2e_latency';\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_PROVIDER_NAME = 'gen_ai.provider.name';\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\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"],"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,qBAAqB;AAC3B,MAAM,4BAA4B;AAClC,MAAM,kBAAkB;AACxB,MAAM,oBAAoB;AAC1B,MAAM,0BAA0B;AAGhC,MAAM,gBAAgB;AACtB,MAAM,sBAAsB;AAC5B,MAAM,sBAAsB;AAC5B,MAAM,iBAAiB;AACvB,MAAM,qBAAqB;AAC3B,MAAM,+BAA+B;AACrC,MAAM,qBAAqB;AAG3B,MAAM,wBAAwB;AAC9B,MAAM,0BAA0B;AAChC,MAAM,0BAA0B;AAChC,MAAM,8BAA8B;AACpC,MAAM,4BAA4B;AAGlC,MAAM,sBAAsB;AAC5B,MAAM,qBAAqB;AAC3B,MAAM,iBAAiB;AACvB,MAAM,qBAAqB;AAG3B,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,mBAAmB;AACzB,MAAM,mBAAmB;AACzB,MAAM,8BAA8B;AAGpC,MAAM,mBAAmB;AAIzB,MAAM,6BAA6B;AACnC,MAAM,4BAA4B;AAClC,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;AAG5C,MAAM,uBAAuB;AAC7B,MAAM,gCAAgC;AACtC,MAAM,mCAAmC;AACzC,MAAM,wCAAwC;AAC9C,MAAM,oCAAoC;","names":[]}
+{"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_AGENT_TURN_ID = 'lk.generation_id';\nexport const ATTR_AGENT_PARENT_TURN_ID = 'lk.parent_generation_id';\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_PROVIDER_TOOLS = 'lk.provider_tools';\nexport const ATTR_TOOL_SETS = 'lk.tool_sets';\nexport const ATTR_RESPONSE_TEXT = 'lk.response.text';\nexport const ATTR_RESPONSE_FUNCTION_CALLS = 'lk.response.function_calls';\n/** Time to first token in seconds. */\nexport const ATTR_RESPONSE_TTFT = 'lk.response.ttft';\n\n// function tool\nexport const ATTR_FUNCTION_TOOL_ID = 'lk.function_tool.id';\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/** Time to first byte in seconds. */\nexport const ATTR_RESPONSE_TTFB = 'lk.response.ttfb';\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/** End-to-end latency in seconds. */\nexport const ATTR_E2E_LATENCY = 'lk.e2e_latency';\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';\n/** The provider name (e.g., 'openai', 'anthropic'). */\nexport const ATTR_GEN_AI_PROVIDER_NAME = 'gen_ai.provider.name';\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,qBAAqB;AAC3B,MAAM,4BAA4B;AAClC,MAAM,kBAAkB;AACxB,MAAM,oBAAoB;AAC1B,MAAM,0BAA0B;AAGhC,MAAM,gBAAgB;AACtB,MAAM,sBAAsB;AAC5B,MAAM,sBAAsB;AAC5B,MAAM,iBAAiB;AACvB,MAAM,qBAAqB;AAC3B,MAAM,+BAA+B;AAErC,MAAM,qBAAqB;AAG3B,MAAM,wBAAwB;AAC9B,MAAM,0BAA0B;AAChC,MAAM,0BAA0B;AAChC,MAAM,8BAA8B;AACpC,MAAM,4BAA4B;AAGlC,MAAM,sBAAsB;AAC5B,MAAM,qBAAqB;AAC3B,MAAM,iBAAiB;AAEvB,MAAM,qBAAqB;AAG3B,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;AAGpC,MAAM,mBAAmB;AAIzB,MAAM,6BAA6B;AACnC,MAAM,4BAA4B;AAElC,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

@@ -47,6 +47,7 @@ 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_model_usage = require("../metrics/model_usage.cjs");
 var import_otel_http_exporter = require("./otel_http_exporter.cjs");
 var import_pino_otel_transport = require("./pino_otel_transport.cjs");
 class DynamicTracer {
@@ -211,25 +212,60 @@ async function setupCloudTracer(options) {
 async function flushOtelLogs() {
   await (0, import_pino_otel_transport.flushPinoLogs)();
 }
+const ROLE_MAP = {
+  developer: "DEVELOPER",
+  system: "SYSTEM",
+  user: "USER",
+  assistant: "ASSISTANT"
+};
 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(),
+      role: ROLE_MAP[item.role] ?? item.role.toUpperCase(),
       content: item.content.map((c) => ({ text: c })),
       createdAt: toRFC3339(item.createdAt)
     };
     if (item.interrupted) {
       msg.interrupted = item.interrupted;
     }
+    if (item.extra && Object.keys(item.extra).length > 0) {
+      msg.extra = item.extra;
+    }
+    if (item.transcriptConfidence !== void 0) {
+      msg.transcriptConfidence = item.transcriptConfidence;
+    }
+    const metrics = item.metrics;
+    if (metrics && Object.keys(metrics).length > 0) {
+      const protoMetrics = {};
+      if (metrics.startedSpeakingAt !== void 0) {
+        protoMetrics.startedSpeakingAt = toRFC3339(metrics.startedSpeakingAt * 1e3);
+      }
+      if (metrics.stoppedSpeakingAt !== void 0) {
+        protoMetrics.stoppedSpeakingAt = toRFC3339(metrics.stoppedSpeakingAt * 1e3);
+      }
+      if (metrics.transcriptionDelay !== void 0) {
+        protoMetrics.transcriptionDelay = metrics.transcriptionDelay;
+      }
+      if (metrics.endOfTurnDelay !== void 0) {
+        protoMetrics.endOfTurnDelay = metrics.endOfTurnDelay;
+      }
+      if (metrics.onUserTurnCompletedDelay !== void 0) {
+        protoMetrics.onUserTurnCompletedDelay = metrics.onUserTurnCompletedDelay;
+      }
+      if (metrics.llmNodeTtft !== void 0) {
+        protoMetrics.llmNodeTtft = metrics.llmNodeTtft;
+      }
+      if (metrics.ttsNodeTtfb !== void 0) {
+        protoMetrics.ttsNodeTtfb = metrics.ttsNodeTtfb;
+      }
+      if (metrics.e2eLatency !== void 0) {
+        protoMetrics.e2eLatency = metrics.e2eLatency;
+      }
+      msg.metrics = protoMetrics;
+    }
     itemDict.message = msg;
   } else if (item.type === "function_call") {
     itemDict.functionCall = {
@@ -275,6 +311,7 @@ function toRFC3339(valueMs) {
   return truncated.toISOString();
 }
 async function uploadSessionReport(options) {
+  var _a;
   const { agentName, cloudHostname, report } = options;
   const logExporter = new import_otel_http_exporter.SimpleOTLPHttpLogExporter({
     cloudHostname,
@@ -295,6 +332,7 @@ async function uploadSessionReport(options) {
     job_id: report.jobId,
     "logger.name": "chat_history"
   };
+  const usage = ((_a = report.modelUsage) == null ? void 0 : _a.map(import_model_usage.filterZeroValues)) || null;
   logRecords.push({
     body: "session report",
     timestampMs: report.startedAt || report.timestamp || 0,
@@ -302,7 +340,8 @@ async function uploadSessionReport(options) {
       ...commonAttrs,
       "session.options": report.options || {},
       "session.report_timestamp": report.timestamp,
-      agent_name: agentName
+      agent_name: agentName,
+      usage
     }
   });
   let lastTimestamp = 0;

package/dist/telemetry/traces.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/telemetry/traces.ts"],"sourcesContent":["// SPDX-FileCopyrightText: 2025 LiveKit, Inc.\n//\n// SPDX-License-Identifier: Apache-2.0\nimport { MetricsRecordingHeader } from '@livekit/protocol';\nimport {\n  type Attributes,\n  type Context,\n  type Span,\n  type SpanOptions,\n  type Tracer,\n  type TracerProvider,\n  context as otelContext,\n  trace,\n} from '@opentelemetry/api';\nimport { SeverityNumber } from '@opentelemetry/api-logs';\nimport { OTLPTraceExporter } from '@opentelemetry/exporter-trace-otlp-proto';\nimport { CompressionAlgorithm } from '@opentelemetry/otlp-exporter-base';\nimport { Resource } from '@opentelemetry/resources';\nimport type { ReadableSpan, SpanProcessor } from '@opentelemetry/sdk-trace-base';\nimport { BatchSpanProcessor, NodeTracerProvider } from '@opentelemetry/sdk-trace-node';\nimport { ATTR_SERVICE_NAME } from '@opentelemetry/semantic-conventions';\nimport FormData from 'form-data';\nimport { AccessToken } from 'livekit-server-sdk';\nimport fs from 'node:fs/promises';\nimport type { ChatContent, ChatItem } from '../llm/index.js';\nimport { enableOtelLogging } from '../log.js';\nimport type { SessionReport } from '../voice/report.js';\nimport { type SimpleLogRecord, SimpleOTLPHttpLogExporter } from './otel_http_exporter.js';\nimport { flushPinoLogs, initPinoCloudExporter } from './pino_otel_transport.js';\n\nexport interface StartSpanOptions {\n  /** Name of the span */\n  name: string;\n  /** Optional parent context to use for this span */\n  context?: Context;\n  /** Attributes to set on the span when it starts */\n  attributes?: Attributes;\n  /** Whether to end the span when the function exits (default: true) */\n  endOnExit?: boolean;\n  /** Optional start time for the span in milliseconds (Date.now() format) */\n  startTime?: number;\n}\n\n/**\n * A dynamic tracer that allows the tracer provider to be changed at runtime.\n */\nclass DynamicTracer {\n  private tracerProvider: TracerProvider;\n  private tracer: Tracer;\n  private readonly instrumentingModuleName: string;\n\n  constructor(instrumentingModuleName: string) {\n    this.instrumentingModuleName = instrumentingModuleName;\n    this.tracerProvider = trace.getTracerProvider();\n    this.tracer = trace.getTracer(instrumentingModuleName);\n  }\n\n  /**\n   * Set a new tracer provider. This updates the underlying tracer instance.\n   * @param provider - The new tracer provider to use\n   */\n  setProvider(provider: TracerProvider): void {\n    this.tracerProvider = provider;\n    this.tracer = this.tracerProvider.getTracer(this.instrumentingModuleName);\n  }\n\n  /**\n   * Get the underlying OpenTelemetry tracer.\n   * Use this to access the full Tracer API when needed.\n   */\n  getTracer(): Tracer {\n    return this.tracer;\n  }\n\n  /**\n   * Start a span manually (without making it active).\n   * You must call span.end() when done.\n   *\n   * @param options - Span configuration including name\n   * @returns The created span\n   */\n  startSpan(options: StartSpanOptions): Span {\n    const ctx = options.context || otelContext.active();\n\n    const span = this.tracer.startSpan(\n      options.name,\n      {\n        attributes: options.attributes,\n        startTime: options.startTime,\n      },\n      ctx,\n    );\n\n    return span;\n  }\n\n  /**\n   * Start a new span and make it active in the current context.\n   * The span will automatically be ended when the provided function completes (unless endOnExit=false).\n   *\n   * @param fn - The function to execute within the span context\n   * @param options - Span configuration including name\n   * @returns The result of the provided function\n   */\n  async startActiveSpan<T>(fn: (span: Span) => Promise<T>, options: StartSpanOptions): Promise<T> {\n    const ctx = options.context || otelContext.active();\n    const endOnExit = options.endOnExit === undefined ? true : options.endOnExit; // default true\n    const opts: SpanOptions = { attributes: options.attributes, startTime: options.startTime };\n\n    // Directly return the tracer's startActiveSpan result - it handles async correctly\n    return await this.tracer.startActiveSpan(options.name, opts, ctx, async (span) => {\n      try {\n        return await fn(span);\n      } finally {\n        if (endOnExit) {\n          span.end();\n        }\n      }\n    });\n  }\n\n  /**\n   * Synchronous version of startActiveSpan for non-async operations.\n   *\n   * @param fn - The function to execute within the span context\n   * @param options - Span configuration including name\n   * @returns The result of the provided function\n   */\n  startActiveSpanSync<T>(fn: (span: Span) => T, options: StartSpanOptions): T {\n    const ctx = options.context || otelContext.active();\n    const endOnExit = options.endOnExit === undefined ? true : options.endOnExit; // default true\n    const opts: SpanOptions = { attributes: options.attributes, startTime: options.startTime };\n\n    return this.tracer.startActiveSpan(options.name, opts, ctx, (span) => {\n      try {\n        return fn(span);\n      } finally {\n        if (endOnExit) {\n          span.end();\n        }\n      }\n    });\n  }\n}\n\n/**\n * The global tracer instance used throughout the agents framework.\n * This tracer can have its provider updated at runtime via setTracerProvider().\n */\nexport const tracer = new DynamicTracer('livekit-agents');\n\nclass MetadataSpanProcessor implements SpanProcessor {\n  private metadata: Attributes;\n\n  constructor(metadata: Attributes) {\n    this.metadata = metadata;\n  }\n\n  onStart(span: Span, _parentContext: Context): void {\n    span.setAttributes(this.metadata);\n  }\n\n  onEnd(_span: ReadableSpan): void {}\n\n  shutdown(): Promise<void> {\n    return Promise.resolve();\n  }\n\n  forceFlush(): Promise<void> {\n    return Promise.resolve();\n  }\n}\n\n/**\n * Set the tracer provider for the livekit-agents framework.\n * This should be called before agent session start if using custom tracer providers.\n *\n * @param provider - The tracer provider to use (must be a NodeTracerProvider)\n * @param options - Optional configuration with metadata property to inject into all spans\n *\n * @example\n * ```typescript\n * import { NodeTracerProvider } from '@opentelemetry/sdk-trace-node';\n * import { setTracerProvider } from '@livekit/agents/telemetry';\n *\n * const provider = new NodeTracerProvider();\n * setTracerProvider(provider, {\n *   metadata: { room_id: 'room123', job_id: 'job456' }\n * });\n * ```\n */\nexport function setTracerProvider(\n  provider: NodeTracerProvider,\n  options?: { metadata?: Attributes },\n): void {\n  if (options?.metadata) {\n    provider.addSpanProcessor(new MetadataSpanProcessor(options.metadata));\n  }\n\n  tracer.setProvider(provider);\n}\n\n/**\n * Setup OpenTelemetry tracer for LiveKit Cloud observability.\n * This configures OTLP exporters to send traces to LiveKit Cloud.\n *\n * @param options - Configuration for cloud tracer with roomId, jobId, and cloudHostname properties\n *\n * @internal\n */\nexport async function setupCloudTracer(options: {\n  roomId: string;\n  jobId: string;\n  cloudHostname: string;\n}): Promise<void> {\n  const { roomId, jobId, cloudHostname } = options;\n\n  const apiKey = process.env.LIVEKIT_API_KEY;\n  const apiSecret = process.env.LIVEKIT_API_SECRET;\n\n  if (!apiKey || !apiSecret) {\n    throw new Error('LIVEKIT_API_KEY and LIVEKIT_API_SECRET must be set for cloud tracing');\n  }\n\n  const token = new AccessToken(apiKey, apiSecret, {\n    identity: 'livekit-agents-telemetry',\n    ttl: '6h',\n  });\n  token.addObservabilityGrant({ write: true });\n\n  try {\n    const jwt = await token.toJwt();\n\n    const headers = {\n      Authorization: `Bearer ${jwt}`,\n    };\n\n    const metadata: Attributes = {\n      room_id: roomId,\n      job_id: jobId,\n    };\n\n    const resource = new Resource({\n      [ATTR_SERVICE_NAME]: 'livekit-agents',\n      room_id: roomId,\n      job_id: jobId,\n    });\n\n    // Configure OTLP exporter to send traces to LiveKit Cloud\n    const spanExporter = new OTLPTraceExporter({\n      url: `https://${cloudHostname}/observability/traces/otlp/v0`,\n      headers,\n      compression: CompressionAlgorithm.GZIP,\n    });\n\n    const tracerProvider = new NodeTracerProvider({\n      resource,\n      spanProcessors: [new MetadataSpanProcessor(metadata), new BatchSpanProcessor(spanExporter)],\n    });\n    tracerProvider.register();\n\n    setTracerProvider(tracerProvider);\n\n    // Initialize standalone Pino cloud exporter (no OTEL SDK dependency)\n    initPinoCloudExporter({\n      cloudHostname,\n      roomId,\n      jobId,\n    });\n\n    enableOtelLogging();\n  } catch (error) {\n    console.error('Failed to setup cloud tracer:', error);\n    throw error;\n  }\n}\n\n/**\n * Flush all pending Pino logs to ensure they are exported.\n * Call this before session/job ends to ensure all logs are sent.\n *\n * @internal\n */\nexport async function flushOtelLogs(): Promise<void> {\n  await flushPinoLogs();\n}\n\n/**\n * Convert ChatItem to proto-compatible dictionary format.\n * TODO: Use actual agent_session proto types once @livekit/protocol v1.43.1+ is published\n */\nfunction chatItemToProto(item: ChatItem): Record<string, any> {\n  const itemDict: Record<string, any> = {};\n\n  if (item.type === 'message') {\n    const roleMap: Record<string, string> = {\n      developer: 'DEVELOPER',\n      system: 'SYSTEM',\n      user: 'USER',\n      assistant: 'ASSISTANT',\n    };\n\n    const msg: Record<string, any> = {\n      id: item.id,\n      role: roleMap[item.role] || item.role.toUpperCase(),\n      content: item.content.map((c: ChatContent) => ({ text: c })),\n      createdAt: toRFC3339(item.createdAt),\n    };\n\n    if (item.interrupted) {\n      msg.interrupted = item.interrupted;\n    }\n\n    // TODO(brian): Add extra and transcriptConfidence to ChatMessage\n    // if (item.extra && Object.keys(item.extra).length > 0) {\n    //   msg.extra = item.extra;\n    // }\n\n    // if (item.transcriptConfidence !== undefined && item.transcriptConfidence !== null) {\n    //   msg.transcriptConfidence = item.transcriptConfidence;\n    // }\n\n    // TODO(brian): Add metrics to ChatMessage\n    // const metrics = item.metrics || {};\n    // if (Object.keys(metrics).length > 0) {\n    //   msg.metrics = {};\n    //   if (metrics.started_speaking_at) {\n    //     msg.metrics.startedSpeakingAt = toRFC3339(metrics.started_speaking_at);\n    //   }\n    //   if (metrics.stopped_speaking_at) {\n    //     msg.metrics.stoppedSpeakingAt = toRFC3339(metrics.stopped_speaking_at);\n    //   }\n    //   if (metrics.transcription_delay !== undefined) {\n    //     msg.metrics.transcriptionDelay = metrics.transcription_delay;\n    //   }\n    //   if (metrics.end_of_turn_delay !== undefined) {\n    //     msg.metrics.endOfTurnDelay = metrics.end_of_turn_delay;\n    //   }\n    //   if (metrics.on_user_turn_completed_delay !== undefined) {\n    //     msg.metrics.onUserTurnCompletedDelay = metrics.on_user_turn_completed_delay;\n    //   }\n    //   if (metrics.llm_node_ttft !== undefined) {\n    //     msg.metrics.llmNodeTtft = metrics.llm_node_ttft;\n    //   }\n    //   if (metrics.tts_node_ttfb !== undefined) {\n    //     msg.metrics.ttsNodeTtfb = metrics.tts_node_ttfb;\n    //   }\n    //   if (metrics.e2e_latency !== undefined) {\n    //     msg.metrics.e2eLatency = metrics.e2e_latency;\n    //   }\n    // }\n\n    itemDict.message = msg;\n  } else if (item.type === 'function_call') {\n    itemDict.functionCall = {\n      id: item.id,\n      callId: item.callId,\n      arguments: item.args,\n      name: item.name,\n      createdAt: toRFC3339(item.createdAt),\n    };\n  } else if (item.type === 'function_call_output') {\n    itemDict.functionCallOutput = {\n      id: item.id,\n      name: item.name,\n      callId: item.callId,\n      output: item.output,\n      isError: item.isError,\n      createdAt: toRFC3339(item.createdAt),\n    };\n  } else if (item.type === 'agent_handoff') {\n    const handoff: Record<string, any> = {\n      id: item.id,\n      newAgentId: item.newAgentId,\n      createdAt: toRFC3339(item.createdAt),\n    };\n    if (item.oldAgentId !== undefined && item.oldAgentId !== null && item.oldAgentId !== '') {\n      handoff.oldAgentId = item.oldAgentId;\n    }\n    itemDict.agentHandoff = handoff;\n  }\n\n  try {\n    if (item.type === 'function_call' && typeof itemDict.functionCall?.arguments === 'string') {\n      itemDict.functionCall.arguments = JSON.parse(itemDict.functionCall.arguments);\n    } else if (\n      item.type === 'function_call_output' &&\n      typeof itemDict.functionCallOutput?.output === 'string'\n    ) {\n      itemDict.functionCallOutput.output = JSON.parse(itemDict.functionCallOutput.output);\n    }\n  } catch {\n    // ignore parsing errors\n  }\n\n  return itemDict;\n}\n\n/**\n * Convert timestamp to RFC3339 format matching Python's _to_rfc3339.\n * Note: TypeScript createdAt is in milliseconds (Date.now()), not seconds like Python.\n * @internal\n */\nfunction toRFC3339(valueMs: number | Date): string {\n  // valueMs is already in milliseconds (from Date.now())\n  const dt = valueMs instanceof Date ? valueMs : new Date(valueMs);\n  // Truncate sub-millisecond precision\n  const truncated = new Date(Math.floor(dt.getTime()));\n  return truncated.toISOString();\n}\n\n/**\n * Upload session report to LiveKit Cloud observability.\n * @param options - Configuration with agentName, cloudHostname, and report\n */\nexport async function uploadSessionReport(options: {\n  agentName: string;\n  cloudHostname: string;\n  report: SessionReport;\n}): Promise<void> {\n  const { agentName, cloudHostname, report } = options;\n\n  // Create OTLP HTTP exporter for chat history logs\n  // Uses raw HTTP JSON format which is required by LiveKit Cloud\n  const logExporter = new SimpleOTLPHttpLogExporter({\n    cloudHostname,\n    resourceAttributes: {\n      room_id: report.roomId,\n      job_id: report.jobId,\n    },\n    scopeName: 'chat_history',\n    scopeAttributes: {\n      room_id: report.roomId,\n      job_id: report.jobId,\n      room: report.room,\n    },\n  });\n\n  // Build log records for session report and chat items\n  const logRecords: SimpleLogRecord[] = [];\n\n  const commonAttrs = {\n    room_id: report.roomId,\n    job_id: report.jobId,\n    'logger.name': 'chat_history',\n  };\n\n  logRecords.push({\n    body: 'session report',\n    timestampMs: report.startedAt || report.timestamp || 0,\n    attributes: {\n      ...commonAttrs,\n      'session.options': report.options || {},\n      'session.report_timestamp': report.timestamp,\n      agent_name: agentName,\n    },\n  });\n\n  // Track last timestamp to ensure monotonic ordering when items have identical timestamps\n  // This fixes the issue where function_call and function_call_output with same timestamp\n  // get reordered by the dashboard\n  let lastTimestamp = 0;\n  for (const item of report.chatHistory.items) {\n    // Skip null/undefined items\n    if (!item) continue;\n\n    // Ensure monotonically increasing timestamps for proper ordering\n    // Add 0.001ms (1 microsecond) offset when timestamps collide\n    // Also handle undefined/NaN timestamps from realtime mode (defensive)\n    const hasValidTimestamp = Number.isFinite(item.createdAt);\n    let itemTimestamp = hasValidTimestamp ? item.createdAt : Date.now();\n\n    if (itemTimestamp <= lastTimestamp) {\n      itemTimestamp = lastTimestamp + 0.001; // Add 1 microsecond\n    }\n    lastTimestamp = itemTimestamp;\n\n    const itemProto = chatItemToProto(item);\n    let severityNumber = SeverityNumber.UNSPECIFIED;\n    let severityText = 'unspecified';\n\n    if (item.type === 'function_call_output' && item.isError) {\n      severityNumber = SeverityNumber.ERROR;\n      severityText = 'error';\n    }\n\n    logRecords.push({\n      body: 'chat item',\n      timestampMs: itemTimestamp, // Adjusted for monotonic ordering\n      attributes: { 'chat.item': itemProto, ...commonAttrs },\n      severityNumber,\n      severityText,\n    });\n  }\n\n  await logExporter.export(logRecords);\n\n  const apiKey = process.env.LIVEKIT_API_KEY;\n  const apiSecret = process.env.LIVEKIT_API_SECRET;\n\n  if (!apiKey || !apiSecret) {\n    throw new Error('LIVEKIT_API_KEY and LIVEKIT_API_SECRET must be set for session upload');\n  }\n\n  const token = new AccessToken(apiKey, apiSecret, { ttl: '6h' });\n  token.addObservabilityGrant({ write: true });\n  const jwt = await token.toJwt();\n\n  const formData = new FormData();\n\n  // Add header (protobuf MetricsRecordingHeader)\n  const audioStartTime = report.audioRecordingStartedAt ?? 0;\n  const headerMsg = new MetricsRecordingHeader({\n    roomId: report.roomId,\n    duration: BigInt(0), // TODO: Calculate actual duration from report\n    startTime: {\n      seconds: BigInt(Math.floor(audioStartTime / 1000)),\n      nanos: Math.floor((audioStartTime % 1000) * 1e6),\n    },\n  });\n\n  const headerBytes = Buffer.from(headerMsg.toBinary());\n  formData.append('header', headerBytes, {\n    filename: 'header.binpb',\n    contentType: 'application/protobuf',\n    knownLength: headerBytes.length,\n    header: {\n      'Content-Type': 'application/protobuf',\n      'Content-Length': headerBytes.length.toString(),\n    },\n  });\n\n  // Add chat_history JSON\n  const chatHistoryJson = JSON.stringify(report.chatHistory.toJSON({ excludeTimestamp: false }));\n  const chatHistoryBuffer = Buffer.from(chatHistoryJson, 'utf-8');\n  formData.append('chat_history', chatHistoryBuffer, {\n    filename: 'chat_history.json',\n    contentType: 'application/json',\n    knownLength: chatHistoryBuffer.length,\n    header: {\n      'Content-Type': 'application/json',\n      'Content-Length': chatHistoryBuffer.length.toString(),\n    },\n  });\n\n  // Add audio recording file if available\n  if (report.audioRecordingPath && report.audioRecordingStartedAt) {\n    let audioBytes: Buffer;\n    try {\n      audioBytes = await fs.readFile(report.audioRecordingPath);\n    } catch {\n      audioBytes = Buffer.alloc(0);\n    }\n\n    if (audioBytes.length > 0) {\n      formData.append('audio', audioBytes, {\n        filename: 'recording.ogg',\n        contentType: 'audio/ogg',\n        knownLength: audioBytes.length,\n        header: {\n          'Content-Type': 'audio/ogg',\n          'Content-Length': audioBytes.length.toString(),\n        },\n      });\n    }\n  }\n\n  // Upload to LiveKit Cloud using form-data's submit method\n  // This properly streams the multipart form with all headers including Content-Length\n  return new Promise<void>((resolve, reject) => {\n    formData.submit(\n      {\n        protocol: 'https:',\n        host: cloudHostname,\n        path: '/observability/recordings/v0',\n        method: 'POST',\n        headers: {\n          Authorization: `Bearer ${jwt}`,\n        },\n      },\n      (err, res) => {\n        if (err) {\n          reject(new Error(`Failed to upload session report: ${err.message}`));\n          return;\n        }\n\n        if (res.statusCode && res.statusCode >= 400) {\n          // Read response body for error details\n          let body = '';\n          res.on('data', (chunk) => {\n            body += chunk.toString();\n          });\n          res.on('error', (readErr) => {\n            reject(\n              new Error(\n                `Failed to upload session report: ${res.statusCode} ${res.statusMessage} (body read error: ${readErr.message})`,\n              ),\n            );\n          });\n          res.on('end', () => {\n            reject(\n              new Error(\n                `Failed to upload session report: ${res.statusCode} ${res.statusMessage} - ${body}`,\n              ),\n            );\n          });\n          return;\n        }\n\n        res.resume(); // Drain the response\n        res.on('error', (readErr) => reject(new Error(`Response read error: ${readErr.message}`)));\n        res.on('end', () => resolve());\n      },\n    );\n  });\n}\n"],"mappings":"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","names":["otelContext","FormData","fs"]}
+{"version":3,"sources":["../../src/telemetry/traces.ts"],"sourcesContent":["// SPDX-FileCopyrightText: 2025 LiveKit, Inc.\n//\n// SPDX-License-Identifier: Apache-2.0\nimport { MetricsRecordingHeader } from '@livekit/protocol';\nimport {\n  type Attributes,\n  type Context,\n  type Span,\n  type SpanOptions,\n  type Tracer,\n  type TracerProvider,\n  context as otelContext,\n  trace,\n} from '@opentelemetry/api';\nimport { SeverityNumber } from '@opentelemetry/api-logs';\nimport { OTLPTraceExporter } from '@opentelemetry/exporter-trace-otlp-proto';\nimport { CompressionAlgorithm } from '@opentelemetry/otlp-exporter-base';\nimport { Resource } from '@opentelemetry/resources';\nimport type { ReadableSpan, SpanProcessor } from '@opentelemetry/sdk-trace-base';\nimport { BatchSpanProcessor, NodeTracerProvider } from '@opentelemetry/sdk-trace-node';\nimport { ATTR_SERVICE_NAME } from '@opentelemetry/semantic-conventions';\nimport FormData from 'form-data';\nimport { AccessToken } from 'livekit-server-sdk';\nimport fs from 'node:fs/promises';\nimport type { ChatContent, ChatItem, ChatRole } from '../llm/index.js';\nimport { enableOtelLogging } from '../log.js';\nimport { filterZeroValues } from '../metrics/model_usage.js';\nimport type { SessionReport } from '../voice/report.js';\nimport { type SimpleLogRecord, SimpleOTLPHttpLogExporter } from './otel_http_exporter.js';\nimport { flushPinoLogs, initPinoCloudExporter } from './pino_otel_transport.js';\n\nexport interface StartSpanOptions {\n  /** Name of the span */\n  name: string;\n  /** Optional parent context to use for this span */\n  context?: Context;\n  /** Attributes to set on the span when it starts */\n  attributes?: Attributes;\n  /** Whether to end the span when the function exits (default: true) */\n  endOnExit?: boolean;\n  /** Optional start time for the span in milliseconds (Date.now() format) */\n  startTime?: number;\n}\n\n/**\n * A dynamic tracer that allows the tracer provider to be changed at runtime.\n */\nclass DynamicTracer {\n  private tracerProvider: TracerProvider;\n  private tracer: Tracer;\n  private readonly instrumentingModuleName: string;\n\n  constructor(instrumentingModuleName: string) {\n    this.instrumentingModuleName = instrumentingModuleName;\n    this.tracerProvider = trace.getTracerProvider();\n    this.tracer = trace.getTracer(instrumentingModuleName);\n  }\n\n  /**\n   * Set a new tracer provider. This updates the underlying tracer instance.\n   * @param provider - The new tracer provider to use\n   */\n  setProvider(provider: TracerProvider): void {\n    this.tracerProvider = provider;\n    this.tracer = this.tracerProvider.getTracer(this.instrumentingModuleName);\n  }\n\n  /**\n   * Get the underlying OpenTelemetry tracer.\n   * Use this to access the full Tracer API when needed.\n   */\n  getTracer(): Tracer {\n    return this.tracer;\n  }\n\n  /**\n   * Start a span manually (without making it active).\n   * You must call span.end() when done.\n   *\n   * @param options - Span configuration including name\n   * @returns The created span\n   */\n  startSpan(options: StartSpanOptions): Span {\n    const ctx = options.context || otelContext.active();\n\n    const span = this.tracer.startSpan(\n      options.name,\n      {\n        attributes: options.attributes,\n        startTime: options.startTime,\n      },\n      ctx,\n    );\n\n    return span;\n  }\n\n  /**\n   * Start a new span and make it active in the current context.\n   * The span will automatically be ended when the provided function completes (unless endOnExit=false).\n   *\n   * @param fn - The function to execute within the span context\n   * @param options - Span configuration including name\n   * @returns The result of the provided function\n   */\n  async startActiveSpan<T>(fn: (span: Span) => Promise<T>, options: StartSpanOptions): Promise<T> {\n    const ctx = options.context || otelContext.active();\n    const endOnExit = options.endOnExit === undefined ? true : options.endOnExit; // default true\n    const opts: SpanOptions = { attributes: options.attributes, startTime: options.startTime };\n\n    // Directly return the tracer's startActiveSpan result - it handles async correctly\n    return await this.tracer.startActiveSpan(options.name, opts, ctx, async (span) => {\n      try {\n        return await fn(span);\n      } finally {\n        if (endOnExit) {\n          span.end();\n        }\n      }\n    });\n  }\n\n  /**\n   * Synchronous version of startActiveSpan for non-async operations.\n   *\n   * @param fn - The function to execute within the span context\n   * @param options - Span configuration including name\n   * @returns The result of the provided function\n   */\n  startActiveSpanSync<T>(fn: (span: Span) => T, options: StartSpanOptions): T {\n    const ctx = options.context || otelContext.active();\n    const endOnExit = options.endOnExit === undefined ? true : options.endOnExit; // default true\n    const opts: SpanOptions = { attributes: options.attributes, startTime: options.startTime };\n\n    return this.tracer.startActiveSpan(options.name, opts, ctx, (span) => {\n      try {\n        return fn(span);\n      } finally {\n        if (endOnExit) {\n          span.end();\n        }\n      }\n    });\n  }\n}\n\n/**\n * The global tracer instance used throughout the agents framework.\n * This tracer can have its provider updated at runtime via setTracerProvider().\n */\nexport const tracer = new DynamicTracer('livekit-agents');\n\nclass MetadataSpanProcessor implements SpanProcessor {\n  private metadata: Attributes;\n\n  constructor(metadata: Attributes) {\n    this.metadata = metadata;\n  }\n\n  onStart(span: Span, _parentContext: Context): void {\n    span.setAttributes(this.metadata);\n  }\n\n  onEnd(_span: ReadableSpan): void {}\n\n  shutdown(): Promise<void> {\n    return Promise.resolve();\n  }\n\n  forceFlush(): Promise<void> {\n    return Promise.resolve();\n  }\n}\n\n/**\n * Set the tracer provider for the livekit-agents framework.\n * This should be called before agent session start if using custom tracer providers.\n *\n * @param provider - The tracer provider to use (must be a NodeTracerProvider)\n * @param options - Optional configuration with metadata property to inject into all spans\n *\n * @example\n * ```typescript\n * import { NodeTracerProvider } from '@opentelemetry/sdk-trace-node';\n * import { setTracerProvider } from '@livekit/agents/telemetry';\n *\n * const provider = new NodeTracerProvider();\n * setTracerProvider(provider, {\n *   metadata: { room_id: 'room123', job_id: 'job456' }\n * });\n * ```\n */\nexport function setTracerProvider(\n  provider: NodeTracerProvider,\n  options?: { metadata?: Attributes },\n): void {\n  if (options?.metadata) {\n    provider.addSpanProcessor(new MetadataSpanProcessor(options.metadata));\n  }\n\n  tracer.setProvider(provider);\n}\n\n/**\n * Setup OpenTelemetry tracer for LiveKit Cloud observability.\n * This configures OTLP exporters to send traces to LiveKit Cloud.\n *\n * @param options - Configuration for cloud tracer with roomId, jobId, and cloudHostname properties\n *\n * @internal\n */\nexport async function setupCloudTracer(options: {\n  roomId: string;\n  jobId: string;\n  cloudHostname: string;\n}): Promise<void> {\n  const { roomId, jobId, cloudHostname } = options;\n\n  const apiKey = process.env.LIVEKIT_API_KEY;\n  const apiSecret = process.env.LIVEKIT_API_SECRET;\n\n  if (!apiKey || !apiSecret) {\n    throw new Error('LIVEKIT_API_KEY and LIVEKIT_API_SECRET must be set for cloud tracing');\n  }\n\n  const token = new AccessToken(apiKey, apiSecret, {\n    identity: 'livekit-agents-telemetry',\n    ttl: '6h',\n  });\n  token.addObservabilityGrant({ write: true });\n\n  try {\n    const jwt = await token.toJwt();\n\n    const headers = {\n      Authorization: `Bearer ${jwt}`,\n    };\n\n    const metadata: Attributes = {\n      room_id: roomId,\n      job_id: jobId,\n    };\n\n    const resource = new Resource({\n      [ATTR_SERVICE_NAME]: 'livekit-agents',\n      room_id: roomId,\n      job_id: jobId,\n    });\n\n    // Configure OTLP exporter to send traces to LiveKit Cloud\n    const spanExporter = new OTLPTraceExporter({\n      url: `https://${cloudHostname}/observability/traces/otlp/v0`,\n      headers,\n      compression: CompressionAlgorithm.GZIP,\n    });\n\n    const tracerProvider = new NodeTracerProvider({\n      resource,\n      spanProcessors: [new MetadataSpanProcessor(metadata), new BatchSpanProcessor(spanExporter)],\n    });\n    tracerProvider.register();\n\n    setTracerProvider(tracerProvider);\n\n    // Initialize standalone Pino cloud exporter (no OTEL SDK dependency)\n    initPinoCloudExporter({\n      cloudHostname,\n      roomId,\n      jobId,\n    });\n\n    enableOtelLogging();\n  } catch (error) {\n    console.error('Failed to setup cloud tracer:', error);\n    throw error;\n  }\n}\n\n/**\n * Flush all pending Pino logs to ensure they are exported.\n * Call this before session/job ends to ensure all logs are sent.\n *\n * @internal\n */\nexport async function flushOtelLogs(): Promise<void> {\n  await flushPinoLogs();\n}\n\n/** Proto-compatible role enum values. */\ntype ProtoRole = 'DEVELOPER' | 'SYSTEM' | 'USER' | 'ASSISTANT';\n\nconst ROLE_MAP: Record<ChatRole, ProtoRole> = {\n  developer: 'DEVELOPER',\n  system: 'SYSTEM',\n  user: 'USER',\n  assistant: 'ASSISTANT',\n};\n\ninterface ProtoMetricsReport {\n  startedSpeakingAt?: string;\n  stoppedSpeakingAt?: string;\n  transcriptionDelay?: number;\n  endOfTurnDelay?: number;\n  onUserTurnCompletedDelay?: number;\n  llmNodeTtft?: number;\n  ttsNodeTtfb?: number;\n  e2eLatency?: number;\n}\n\ninterface ProtoMessage {\n  id: string;\n  role: ProtoRole;\n  content: { text: ChatContent }[];\n  createdAt: string;\n  interrupted?: boolean;\n  extra?: Record<string, unknown>;\n  transcriptConfidence?: number;\n  metrics?: ProtoMetricsReport;\n}\n\ninterface ProtoFunctionCall {\n  id: string;\n  callId: string;\n  arguments: string | Record<string, unknown>;\n  name: string;\n  createdAt: string;\n}\n\ninterface ProtoFunctionCallOutput {\n  id: string;\n  name: string;\n  callId: string;\n  output: string;\n  isError: boolean;\n  createdAt: string;\n}\n\ninterface ProtoAgentHandoff {\n  id: string;\n  newAgentId: string;\n  createdAt: string;\n  oldAgentId?: string;\n}\n\ninterface ProtoChatItem {\n  message?: ProtoMessage;\n  functionCall?: ProtoFunctionCall;\n  functionCallOutput?: ProtoFunctionCallOutput;\n  agentHandoff?: ProtoAgentHandoff;\n}\n\n/**\n * Convert ChatItem to proto-compatible dictionary format.\n * TODO: Use actual agent_session proto types once @livekit/protocol v1.43.1+ is published\n */\nfunction chatItemToProto(item: ChatItem): ProtoChatItem {\n  const itemDict: ProtoChatItem = {};\n\n  if (item.type === 'message') {\n    const msg: ProtoMessage = {\n      id: item.id,\n      role: ROLE_MAP[item.role] ?? (item.role.toUpperCase() as ProtoRole),\n      content: item.content.map((c: ChatContent) => ({ text: c })),\n      createdAt: toRFC3339(item.createdAt),\n    };\n\n    if (item.interrupted) {\n      msg.interrupted = item.interrupted;\n    }\n\n    if (item.extra && Object.keys(item.extra).length > 0) {\n      msg.extra = item.extra;\n    }\n\n    if (item.transcriptConfidence !== undefined) {\n      msg.transcriptConfidence = item.transcriptConfidence;\n    }\n\n    const metrics = item.metrics;\n    if (metrics && Object.keys(metrics).length > 0) {\n      const protoMetrics: ProtoMetricsReport = {};\n      if (metrics.startedSpeakingAt !== undefined) {\n        protoMetrics.startedSpeakingAt = toRFC3339(metrics.startedSpeakingAt * 1000);\n      }\n      if (metrics.stoppedSpeakingAt !== undefined) {\n        protoMetrics.stoppedSpeakingAt = toRFC3339(metrics.stoppedSpeakingAt * 1000);\n      }\n      if (metrics.transcriptionDelay !== undefined) {\n        protoMetrics.transcriptionDelay = metrics.transcriptionDelay;\n      }\n      if (metrics.endOfTurnDelay !== undefined) {\n        protoMetrics.endOfTurnDelay = metrics.endOfTurnDelay;\n      }\n      if (metrics.onUserTurnCompletedDelay !== undefined) {\n        protoMetrics.onUserTurnCompletedDelay = metrics.onUserTurnCompletedDelay;\n      }\n      if (metrics.llmNodeTtft !== undefined) {\n        protoMetrics.llmNodeTtft = metrics.llmNodeTtft;\n      }\n      if (metrics.ttsNodeTtfb !== undefined) {\n        protoMetrics.ttsNodeTtfb = metrics.ttsNodeTtfb;\n      }\n      if (metrics.e2eLatency !== undefined) {\n        protoMetrics.e2eLatency = metrics.e2eLatency;\n      }\n      msg.metrics = protoMetrics;\n    }\n\n    itemDict.message = msg;\n  } else if (item.type === 'function_call') {\n    itemDict.functionCall = {\n      id: item.id,\n      callId: item.callId,\n      arguments: item.args,\n      name: item.name,\n      createdAt: toRFC3339(item.createdAt),\n    };\n  } else if (item.type === 'function_call_output') {\n    itemDict.functionCallOutput = {\n      id: item.id,\n      name: item.name,\n      callId: item.callId,\n      output: item.output,\n      isError: item.isError,\n      createdAt: toRFC3339(item.createdAt),\n    };\n  } else if (item.type === 'agent_handoff') {\n    const handoff: ProtoAgentHandoff = {\n      id: item.id,\n      newAgentId: item.newAgentId,\n      createdAt: toRFC3339(item.createdAt),\n    };\n    if (item.oldAgentId !== undefined && item.oldAgentId !== null && item.oldAgentId !== '') {\n      handoff.oldAgentId = item.oldAgentId;\n    }\n    itemDict.agentHandoff = handoff;\n  }\n\n  try {\n    if (item.type === 'function_call' && typeof itemDict.functionCall?.arguments === 'string') {\n      itemDict.functionCall.arguments = JSON.parse(itemDict.functionCall.arguments);\n    } else if (\n      item.type === 'function_call_output' &&\n      typeof itemDict.functionCallOutput?.output === 'string'\n    ) {\n      itemDict.functionCallOutput.output = JSON.parse(itemDict.functionCallOutput.output);\n    }\n  } catch {\n    // ignore parsing errors\n  }\n\n  return itemDict;\n}\n\n/**\n * Convert timestamp to RFC3339 format\n */\nfunction toRFC3339(valueMs: number | Date): string {\n  // valueMs is already in milliseconds (from Date.now())\n  const dt = valueMs instanceof Date ? valueMs : new Date(valueMs);\n  // Truncate sub-millisecond precision\n  const truncated = new Date(Math.floor(dt.getTime()));\n  return truncated.toISOString();\n}\n\n/**\n * Upload session report to LiveKit Cloud observability.\n * @param options - Configuration with agentName, cloudHostname, and report\n */\nexport async function uploadSessionReport(options: {\n  agentName: string;\n  cloudHostname: string;\n  report: SessionReport;\n}): Promise<void> {\n  const { agentName, cloudHostname, report } = options;\n\n  // Create OTLP HTTP exporter for chat history logs\n  // Uses raw HTTP JSON format which is required by LiveKit Cloud\n  const logExporter = new SimpleOTLPHttpLogExporter({\n    cloudHostname,\n    resourceAttributes: {\n      room_id: report.roomId,\n      job_id: report.jobId,\n    },\n    scopeName: 'chat_history',\n    scopeAttributes: {\n      room_id: report.roomId,\n      job_id: report.jobId,\n      room: report.room,\n    },\n  });\n\n  // Build log records for session report and chat items\n  const logRecords: SimpleLogRecord[] = [];\n\n  const commonAttrs = {\n    room_id: report.roomId,\n    job_id: report.jobId,\n    'logger.name': 'chat_history',\n  };\n\n  const usage = report.modelUsage?.map(filterZeroValues) || null;\n\n  logRecords.push({\n    body: 'session report',\n    timestampMs: report.startedAt || report.timestamp || 0,\n    attributes: {\n      ...commonAttrs,\n      'session.options': report.options || {},\n      'session.report_timestamp': report.timestamp,\n      agent_name: agentName,\n      usage,\n    },\n  });\n\n  // Track last timestamp to ensure monotonic ordering when items have identical timestamps\n  // This fixes the issue where function_call and function_call_output with same timestamp\n  // get reordered by the dashboard\n  let lastTimestamp = 0;\n  for (const item of report.chatHistory.items) {\n    // Skip null/undefined items\n    if (!item) continue;\n\n    // Ensure monotonically increasing timestamps for proper ordering\n    // Add 0.001ms (1 microsecond) offset when timestamps collide\n    // Also handle undefined/NaN timestamps from realtime mode (defensive)\n    const hasValidTimestamp = Number.isFinite(item.createdAt);\n    let itemTimestamp = hasValidTimestamp ? item.createdAt : Date.now();\n\n    if (itemTimestamp <= lastTimestamp) {\n      itemTimestamp = lastTimestamp + 0.001; // Add 1 microsecond\n    }\n    lastTimestamp = itemTimestamp;\n\n    const itemProto = chatItemToProto(item);\n    let severityNumber = SeverityNumber.UNSPECIFIED;\n    let severityText = 'unspecified';\n\n    if (item.type === 'function_call_output' && item.isError) {\n      severityNumber = SeverityNumber.ERROR;\n      severityText = 'error';\n    }\n\n    logRecords.push({\n      body: 'chat item',\n      timestampMs: itemTimestamp, // Adjusted for monotonic ordering\n      attributes: { 'chat.item': itemProto, ...commonAttrs },\n      severityNumber,\n      severityText,\n    });\n  }\n\n  await logExporter.export(logRecords);\n\n  const apiKey = process.env.LIVEKIT_API_KEY;\n  const apiSecret = process.env.LIVEKIT_API_SECRET;\n\n  if (!apiKey || !apiSecret) {\n    throw new Error('LIVEKIT_API_KEY and LIVEKIT_API_SECRET must be set for session upload');\n  }\n\n  const token = new AccessToken(apiKey, apiSecret, { ttl: '6h' });\n  token.addObservabilityGrant({ write: true });\n  const jwt = await token.toJwt();\n\n  const formData = new FormData();\n\n  // Add header (protobuf MetricsRecordingHeader)\n  const audioStartTime = report.audioRecordingStartedAt ?? 0;\n  const headerMsg = new MetricsRecordingHeader({\n    roomId: report.roomId,\n    duration: BigInt(0), // TODO: Calculate actual duration from report\n    startTime: {\n      seconds: BigInt(Math.floor(audioStartTime / 1000)),\n      nanos: Math.floor((audioStartTime % 1000) * 1e6),\n    },\n  });\n\n  const headerBytes = Buffer.from(headerMsg.toBinary());\n  formData.append('header', headerBytes, {\n    filename: 'header.binpb',\n    contentType: 'application/protobuf',\n    knownLength: headerBytes.length,\n    header: {\n      'Content-Type': 'application/protobuf',\n      'Content-Length': headerBytes.length.toString(),\n    },\n  });\n\n  // Add chat_history JSON\n  const chatHistoryJson = JSON.stringify(report.chatHistory.toJSON({ excludeTimestamp: false }));\n  const chatHistoryBuffer = Buffer.from(chatHistoryJson, 'utf-8');\n  formData.append('chat_history', chatHistoryBuffer, {\n    filename: 'chat_history.json',\n    contentType: 'application/json',\n    knownLength: chatHistoryBuffer.length,\n    header: {\n      'Content-Type': 'application/json',\n      'Content-Length': chatHistoryBuffer.length.toString(),\n    },\n  });\n\n  // Add audio recording file if available\n  if (report.audioRecordingPath && report.audioRecordingStartedAt) {\n    let audioBytes: Buffer;\n    try {\n      audioBytes = await fs.readFile(report.audioRecordingPath);\n    } catch {\n      audioBytes = Buffer.alloc(0);\n    }\n\n    if (audioBytes.length > 0) {\n      formData.append('audio', audioBytes, {\n        filename: 'recording.ogg',\n        contentType: 'audio/ogg',\n        knownLength: audioBytes.length,\n        header: {\n          'Content-Type': 'audio/ogg',\n          'Content-Length': audioBytes.length.toString(),\n        },\n      });\n    }\n  }\n\n  // Upload to LiveKit Cloud using form-data's submit method\n  // This properly streams the multipart form with all headers including Content-Length\n  return new Promise<void>((resolve, reject) => {\n    formData.submit(\n      {\n        protocol: 'https:',\n        host: cloudHostname,\n        path: '/observability/recordings/v0',\n        method: 'POST',\n        headers: {\n          Authorization: `Bearer ${jwt}`,\n        },\n      },\n      (err, res) => {\n        if (err) {\n          reject(new Error(`Failed to upload session report: ${err.message}`));\n          return;\n        }\n\n        if (res.statusCode && res.statusCode >= 400) {\n          // Read response body for error details\n          let body = '';\n          res.on('data', (chunk) => {\n            body += chunk.toString();\n          });\n          res.on('error', (readErr) => {\n            reject(\n              new Error(\n                `Failed to upload session report: ${res.statusCode} ${res.statusMessage} (body read error: ${readErr.message})`,\n              ),\n            );\n          });\n          res.on('end', () => {\n            reject(\n              new Error(\n                `Failed to upload session report: ${res.statusCode} ${res.statusMessage} - ${body}`,\n              ),\n            );\n          });\n          return;\n        }\n\n        res.resume(); // Drain the response\n        res.on('error', (readErr) => reject(new Error(`Response read error: ${readErr.message}`)));\n        res.on('end', () => resolve());\n      },\n    );\n  });\n}\n"],"mappings":"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","names":["otelContext","FormData","fs"]}

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

@@ -1 +1 @@
-{"version":3,"file":"traces.d.ts","sourceRoot":"","sources":["../../src/telemetry/traces.ts"],"names":[],"mappings":"AAIA,OAAO,EACL,KAAK,UAAU,EACf,KAAK,OAAO,EACZ,KAAK,IAAI,EAET,KAAK,MAAM,EACX,KAAK,cAAc,EAGpB,MAAM,oBAAoB,CAAC;AAM5B,OAAO,EAAsB,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AAOvF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAIxD,MAAM,WAAW,gBAAgB;IAC/B,uBAAuB;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,mDAAmD;IACnD,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,mDAAmD;IACnD,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,sEAAsE;IACtE,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,2EAA2E;IAC3E,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,cAAM,aAAa;IACjB,OAAO,CAAC,cAAc,CAAiB;IACvC,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,QAAQ,CAAC,uBAAuB,CAAS;gBAErC,uBAAuB,EAAE,MAAM;IAM3C;;;OAGG;IACH,WAAW,CAAC,QAAQ,EAAE,cAAc,GAAG,IAAI;IAK3C;;;OAGG;IACH,SAAS,IAAI,MAAM;IAInB;;;;;;OAMG;IACH,SAAS,CAAC,OAAO,EAAE,gBAAgB,GAAG,IAAI;IAe1C;;;;;;;OAOG;IACG,eAAe,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,CAAC,CAAC;IAiB/F;;;;;;OAMG;IACH,mBAAmB,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,CAAC,EAAE,OAAO,EAAE,gBAAgB,GAAG,CAAC;CAe5E;AAED;;;GAGG;AACH,eAAO,MAAM,MAAM,eAAsC,CAAC;AAwB1D;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,kBAAkB,EAC5B,OAAO,CAAC,EAAE;IAAE,QAAQ,CAAC,EAAE,UAAU,CAAA;CAAE,GAClC,IAAI,CAMN;AAED;;;;;;;GAOG;AACH,wBAAsB,gBAAgB,CAAC,OAAO,EAAE;IAC9C,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,EAAE,MAAM,CAAC;CACvB,GAAG,OAAO,CAAC,IAAI,CAAC,CA6DhB;AAED;;;;;GAKG;AACH,wBAAsB,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC,CAEnD;AA8HD;;;GAGG;AACH,wBAAsB,mBAAmB,CAAC,OAAO,EAAE;IACjD,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,aAAa,CAAC;CACvB,GAAG,OAAO,CAAC,IAAI,CAAC,CAoMhB"}
+{"version":3,"file":"traces.d.ts","sourceRoot":"","sources":["../../src/telemetry/traces.ts"],"names":[],"mappings":"AAIA,OAAO,EACL,KAAK,UAAU,EACf,KAAK,OAAO,EACZ,KAAK,IAAI,EAET,KAAK,MAAM,EACX,KAAK,cAAc,EAGpB,MAAM,oBAAoB,CAAC;AAM5B,OAAO,EAAsB,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AAQvF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAIxD,MAAM,WAAW,gBAAgB;IAC/B,uBAAuB;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,mDAAmD;IACnD,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,mDAAmD;IACnD,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,sEAAsE;IACtE,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,2EAA2E;IAC3E,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,cAAM,aAAa;IACjB,OAAO,CAAC,cAAc,CAAiB;IACvC,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,QAAQ,CAAC,uBAAuB,CAAS;gBAErC,uBAAuB,EAAE,MAAM;IAM3C;;;OAGG;IACH,WAAW,CAAC,QAAQ,EAAE,cAAc,GAAG,IAAI;IAK3C;;;OAGG;IACH,SAAS,IAAI,MAAM;IAInB;;;;;;OAMG;IACH,SAAS,CAAC,OAAO,EAAE,gBAAgB,GAAG,IAAI;IAe1C;;;;;;;OAOG;IACG,eAAe,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,CAAC,CAAC;IAiB/F;;;;;;OAMG;IACH,mBAAmB,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,CAAC,EAAE,OAAO,EAAE,gBAAgB,GAAG,CAAC;CAe5E;AAED;;;GAGG;AACH,eAAO,MAAM,MAAM,eAAsC,CAAC;AAwB1D;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,kBAAkB,EAC5B,OAAO,CAAC,EAAE;IAAE,QAAQ,CAAC,EAAE,UAAU,CAAA;CAAE,GAClC,IAAI,CAMN;AAED;;;;;;;GAOG;AACH,wBAAsB,gBAAgB,CAAC,OAAO,EAAE;IAC9C,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,EAAE,MAAM,CAAC;CACvB,GAAG,OAAO,CAAC,IAAI,CAAC,CA6DhB;AAED;;;;;GAKG;AACH,wBAAsB,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC,CAEnD;AAmLD;;;GAGG;AACH,wBAAsB,mBAAmB,CAAC,OAAO,EAAE;IACjD,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,aAAa,CAAC;CACvB,GAAG,OAAO,CAAC,IAAI,CAAC,CAuMhB"}

package/dist/telemetry/traces.js

@@ -13,6 +13,7 @@ import FormData from "form-data";
 import { AccessToken } from "livekit-server-sdk";
 import fs from "node:fs/promises";
 import { enableOtelLogging } from "../log.js";
+import { filterZeroValues } from "../metrics/model_usage.js";
 import { SimpleOTLPHttpLogExporter } from "./otel_http_exporter.js";
 import { flushPinoLogs, initPinoCloudExporter } from "./pino_otel_transport.js";
 class DynamicTracer {
@@ -177,25 +178,60 @@ async function setupCloudTracer(options) {
 async function flushOtelLogs() {
   await flushPinoLogs();
 }
+const ROLE_MAP = {
+  developer: "DEVELOPER",
+  system: "SYSTEM",
+  user: "USER",
+  assistant: "ASSISTANT"
+};
 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(),
+      role: ROLE_MAP[item.role] ?? item.role.toUpperCase(),
       content: item.content.map((c) => ({ text: c })),
       createdAt: toRFC3339(item.createdAt)
     };
     if (item.interrupted) {
       msg.interrupted = item.interrupted;
     }
+    if (item.extra && Object.keys(item.extra).length > 0) {
+      msg.extra = item.extra;
+    }
+    if (item.transcriptConfidence !== void 0) {
+      msg.transcriptConfidence = item.transcriptConfidence;
+    }
+    const metrics = item.metrics;
+    if (metrics && Object.keys(metrics).length > 0) {
+      const protoMetrics = {};
+      if (metrics.startedSpeakingAt !== void 0) {
+        protoMetrics.startedSpeakingAt = toRFC3339(metrics.startedSpeakingAt * 1e3);
+      }
+      if (metrics.stoppedSpeakingAt !== void 0) {
+        protoMetrics.stoppedSpeakingAt = toRFC3339(metrics.stoppedSpeakingAt * 1e3);
+      }
+      if (metrics.transcriptionDelay !== void 0) {
+        protoMetrics.transcriptionDelay = metrics.transcriptionDelay;
+      }
+      if (metrics.endOfTurnDelay !== void 0) {
+        protoMetrics.endOfTurnDelay = metrics.endOfTurnDelay;
+      }
+      if (metrics.onUserTurnCompletedDelay !== void 0) {
+        protoMetrics.onUserTurnCompletedDelay = metrics.onUserTurnCompletedDelay;
+      }
+      if (metrics.llmNodeTtft !== void 0) {
+        protoMetrics.llmNodeTtft = metrics.llmNodeTtft;
+      }
+      if (metrics.ttsNodeTtfb !== void 0) {
+        protoMetrics.ttsNodeTtfb = metrics.ttsNodeTtfb;
+      }
+      if (metrics.e2eLatency !== void 0) {
+        protoMetrics.e2eLatency = metrics.e2eLatency;
+      }
+      msg.metrics = protoMetrics;
+    }
     itemDict.message = msg;
   } else if (item.type === "function_call") {
     itemDict.functionCall = {
@@ -241,6 +277,7 @@ function toRFC3339(valueMs) {
   return truncated.toISOString();
 }
 async function uploadSessionReport(options) {
+  var _a;
   const { agentName, cloudHostname, report } = options;
   const logExporter = new SimpleOTLPHttpLogExporter({
     cloudHostname,
@@ -261,6 +298,7 @@ async function uploadSessionReport(options) {
     job_id: report.jobId,
     "logger.name": "chat_history"
   };
+  const usage = ((_a = report.modelUsage) == null ? void 0 : _a.map(filterZeroValues)) || null;
   logRecords.push({
     body: "session report",
     timestampMs: report.startedAt || report.timestamp || 0,
@@ -268,7 +306,8 @@ async function uploadSessionReport(options) {
       ...commonAttrs,
       "session.options": report.options || {},
       "session.report_timestamp": report.timestamp,
-      agent_name: agentName
+      agent_name: agentName,
+      usage
     }
   });
   let lastTimestamp = 0;