@livekit/agents 1.0.22 → 1.0.23

package/dist/telemetry/pino_otel_transport.js

@@ -0,0 +1,189 @@
+import { SeverityNumber } from "@opentelemetry/api-logs";
+import { AccessToken } from "livekit-server-sdk";
+function mapPinoLevelToSeverity(pinoLevel) {
+  if (pinoLevel <= 10) {
+    return { severityNumber: SeverityNumber.TRACE, severityText: "TRACE" };
+  } else if (pinoLevel <= 20) {
+    return { severityNumber: SeverityNumber.DEBUG, severityText: "DEBUG" };
+  } else if (pinoLevel <= 30) {
+    return { severityNumber: SeverityNumber.INFO, severityText: "INFO" };
+  } else if (pinoLevel <= 40) {
+    return { severityNumber: SeverityNumber.WARN, severityText: "WARN" };
+  } else if (pinoLevel <= 50) {
+    return { severityNumber: SeverityNumber.ERROR, severityText: "ERROR" };
+  } else {
+    return { severityNumber: SeverityNumber.FATAL, severityText: "FATAL" };
+  }
+}
+const EXCLUDE_FIELDS = /* @__PURE__ */ new Set(["level", "time", "msg", "pid", "hostname", "v"]);
+function convertValue(value) {
+  if (value === null || value === void 0) {
+    return { stringValue: "" };
+  }
+  if (typeof value === "string") {
+    return { stringValue: value };
+  }
+  if (typeof value === "number") {
+    return Number.isInteger(value) ? { intValue: String(value) } : { doubleValue: value };
+  }
+  if (typeof value === "boolean") {
+    return { boolValue: value };
+  }
+  if (typeof value === "object") {
+    return { stringValue: JSON.stringify(value) };
+  }
+  return { stringValue: String(value) };
+}
+class PinoCloudExporter {
+  config;
+  loggerName;
+  batchSize;
+  flushIntervalMs;
+  jwt = null;
+  pendingLogs = [];
+  flushTimer = null;
+  constructor(config) {
+    this.config = config;
+    this.loggerName = config.loggerName || "livekit.agents";
+    this.batchSize = config.batchSize || 100;
+    this.flushIntervalMs = config.flushIntervalMs || 5e3;
+  }
+  emit(logObj) {
+    const record = this.convertToOtlpRecord(logObj);
+    this.pendingLogs.push(record);
+    if (!this.flushTimer) {
+      this.flushTimer = setTimeout(() => {
+        this.flush().catch(console.error);
+      }, this.flushIntervalMs);
+    }
+    if (this.pendingLogs.length >= this.batchSize) {
+      this.flush().catch(console.error);
+    }
+  }
+  convertToOtlpRecord(logObj) {
+    const { severityNumber, severityText } = mapPinoLevelToSeverity(logObj.level);
+    const attributes = [
+      { key: "room_id", value: { stringValue: this.config.roomId } },
+      { key: "job_id", value: { stringValue: this.config.jobId } },
+      { key: "logger.name", value: { stringValue: this.loggerName } }
+    ];
+    if (logObj.pid !== void 0) {
+      attributes.push({ key: "process.pid", value: { intValue: String(logObj.pid) } });
+    }
+    if (logObj.hostname !== void 0) {
+      attributes.push({ key: "host.name", value: { stringValue: logObj.hostname } });
+    }
+    for (const [key, value] of Object.entries(logObj)) {
+      if (!EXCLUDE_FIELDS.has(key)) {
+        attributes.push({ key, value: convertValue(value) });
+      }
+    }
+    return {
+      timeUnixNano: String(BigInt(logObj.time) * BigInt(1e6)),
+      observedTimeUnixNano: String(BigInt(Date.now()) * BigInt(1e6)),
+      severityNumber,
+      severityText,
+      body: { stringValue: logObj.msg || "" },
+      attributes,
+      traceId: "",
+      spanId: ""
+    };
+  }
+  async flush() {
+    if (this.flushTimer) {
+      clearTimeout(this.flushTimer);
+      this.flushTimer = null;
+    }
+    if (this.pendingLogs.length === 0) {
+      return;
+    }
+    const logs = this.pendingLogs;
+    this.pendingLogs = [];
+    try {
+      await this.sendLogs(logs);
+    } catch (error) {
+      this.pendingLogs = [...logs, ...this.pendingLogs];
+      console.error("[PinoCloudExporter] Failed to flush logs:", error);
+    }
+  }
+  async sendLogs(logRecords) {
+    await this.ensureJwt();
+    const payload = {
+      resourceLogs: [
+        {
+          resource: {
+            attributes: [
+              { key: "service.name", value: { stringValue: "livekit-agents" } },
+              { key: "room_id", value: { stringValue: this.config.roomId } },
+              { key: "job_id", value: { stringValue: this.config.jobId } }
+            ]
+          },
+          scopeLogs: [
+            {
+              scope: {
+                name: this.loggerName,
+                attributes: [
+                  { key: "room_id", value: { stringValue: this.config.roomId } },
+                  { key: "job_id", value: { stringValue: this.config.jobId } }
+                ]
+              },
+              logRecords
+            }
+          ]
+        }
+      ]
+    };
+    const endpoint = `https://${this.config.cloudHostname}/observability/logs/otlp/v0`;
+    const response = await fetch(endpoint, {
+      method: "POST",
+      headers: {
+        Authorization: `Bearer ${this.jwt}`,
+        "Content-Type": "application/json"
+      },
+      body: JSON.stringify(payload)
+    });
+    if (!response.ok) {
+      const text = await response.text();
+      throw new Error(`Log export failed: ${response.status} ${response.statusText} - ${text}`);
+    }
+  }
+  async ensureJwt() {
+    if (this.jwt) return;
+    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");
+    }
+    const token = new AccessToken(apiKey, apiSecret, { ttl: "6h" });
+    token.addObservabilityGrant({ write: true });
+    this.jwt = await token.toJwt();
+  }
+  async shutdown() {
+    await this.flush();
+  }
+}
+let globalExporter = null;
+function initPinoCloudExporter(config) {
+  globalExporter = new PinoCloudExporter(config);
+}
+function getPinoCloudExporter() {
+  return globalExporter;
+}
+function emitToOtel(logObj) {
+  if (globalExporter) {
+    globalExporter.emit(logObj);
+  }
+}
+async function flushPinoLogs() {
+  if (globalExporter) {
+    await globalExporter.flush();
+  }
+}
+export {
+  PinoCloudExporter,
+  emitToOtel,
+  flushPinoLogs,
+  getPinoCloudExporter,
+  initPinoCloudExporter
+};
+//# sourceMappingURL=pino_otel_transport.js.map

package/dist/telemetry/pino_otel_transport.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/telemetry/pino_otel_transport.ts"],"sourcesContent":["// SPDX-FileCopyrightText: 2025 LiveKit, Inc.\n//\n// SPDX-License-Identifier: Apache-2.0\n\n/**\n * Custom Pino OTEL Transport\n *\n * Standalone exporter for Pino logs to LiveKit Cloud.\n * Uses raw HTTP JSON format, bypassing the OTEL SDK.\n */\nimport { SeverityNumber } from '@opentelemetry/api-logs';\nimport { AccessToken } from 'livekit-server-sdk';\n\nexport interface PinoLogObject {\n  level: number;\n  time: number;\n  msg: string;\n  pid?: number;\n  hostname?: string;\n  [key: string]: unknown;\n}\n\nexport interface PinoCloudExporterConfig {\n  cloudHostname: string;\n  roomId: string;\n  jobId: string;\n  loggerName?: string;\n  batchSize?: number;\n  flushIntervalMs?: number;\n}\n\nfunction mapPinoLevelToSeverity(pinoLevel: number): {\n  severityNumber: SeverityNumber;\n  severityText: string;\n} {\n  if (pinoLevel <= 10) {\n    return { severityNumber: SeverityNumber.TRACE, severityText: 'TRACE' };\n  } else if (pinoLevel <= 20) {\n    return { severityNumber: SeverityNumber.DEBUG, severityText: 'DEBUG' };\n  } else if (pinoLevel <= 30) {\n    return { severityNumber: SeverityNumber.INFO, severityText: 'INFO' };\n  } else if (pinoLevel <= 40) {\n    return { severityNumber: SeverityNumber.WARN, severityText: 'WARN' };\n  } else if (pinoLevel <= 50) {\n    return { severityNumber: SeverityNumber.ERROR, severityText: 'ERROR' };\n  } else {\n    return { severityNumber: SeverityNumber.FATAL, severityText: 'FATAL' };\n  }\n}\n\nconst EXCLUDE_FIELDS = new Set(['level', 'time', 'msg', 'pid', 'hostname', 'v']);\n\nfunction convertValue(value: unknown): unknown {\n  if (value === null || value === undefined) {\n    return { stringValue: '' };\n  }\n  if (typeof value === 'string') {\n    return { stringValue: value };\n  }\n  if (typeof value === 'number') {\n    return Number.isInteger(value) ? { intValue: String(value) } : { doubleValue: value };\n  }\n  if (typeof value === 'boolean') {\n    return { boolValue: value };\n  }\n  if (typeof value === 'object') {\n    return { stringValue: JSON.stringify(value) };\n  }\n  return { stringValue: String(value) };\n}\n\n/**\n * Standalone Pino log exporter for LiveKit Cloud.\n *\n * Collects Pino logs, batches them, and sends via raw HTTP JSON.\n * No OTEL SDK dependency\n *\n * @example\n * ```typescript\n * const exporter = new PinoCloudExporter({\n *   cloudHostname: 'cloud.livekit.io',\n *   roomId: 'RM_xxx',\n *   jobId: 'AJ_xxx',\n * });\n *\n * // In Pino formatter hook:\n * exporter.emit(logObj);\n *\n * // On session end:\n * await exporter.flush();\n * ```\n */\nexport class PinoCloudExporter {\n  private readonly config: PinoCloudExporterConfig;\n  private readonly loggerName: string;\n  private readonly batchSize: number;\n  private readonly flushIntervalMs: number;\n  private jwt: string | null = null;\n  private pendingLogs: any[] = [];\n  private flushTimer: NodeJS.Timeout | null = null;\n\n  constructor(config: PinoCloudExporterConfig) {\n    this.config = config;\n    this.loggerName = config.loggerName || 'livekit.agents';\n    this.batchSize = config.batchSize || 100;\n    this.flushIntervalMs = config.flushIntervalMs || 5000;\n  }\n\n  emit(logObj: PinoLogObject): void {\n    const record = this.convertToOtlpRecord(logObj);\n    this.pendingLogs.push(record);\n\n    if (!this.flushTimer) {\n      this.flushTimer = setTimeout(() => {\n        this.flush().catch(console.error);\n      }, this.flushIntervalMs);\n    }\n\n    if (this.pendingLogs.length >= this.batchSize) {\n      this.flush().catch(console.error);\n    }\n  }\n\n  private convertToOtlpRecord(logObj: PinoLogObject): any {\n    const { severityNumber, severityText } = mapPinoLevelToSeverity(logObj.level);\n\n    const attributes: any[] = [\n      { key: 'room_id', value: { stringValue: this.config.roomId } },\n      { key: 'job_id', value: { stringValue: this.config.jobId } },\n      { key: 'logger.name', value: { stringValue: this.loggerName } },\n    ];\n\n    if (logObj.pid !== undefined) {\n      attributes.push({ key: 'process.pid', value: { intValue: String(logObj.pid) } });\n    }\n    if (logObj.hostname !== undefined) {\n      attributes.push({ key: 'host.name', value: { stringValue: logObj.hostname } });\n    }\n\n    for (const [key, value] of Object.entries(logObj)) {\n      if (!EXCLUDE_FIELDS.has(key)) {\n        attributes.push({ key, value: convertValue(value) });\n      }\n    }\n\n    return {\n      timeUnixNano: String(BigInt(logObj.time) * BigInt(1_000_000)),\n      observedTimeUnixNano: String(BigInt(Date.now()) * BigInt(1_000_000)),\n      severityNumber,\n      severityText,\n      body: { stringValue: logObj.msg || '' },\n      attributes,\n      traceId: '',\n      spanId: '',\n    };\n  }\n\n  async flush(): Promise<void> {\n    if (this.flushTimer) {\n      clearTimeout(this.flushTimer);\n      this.flushTimer = null;\n    }\n\n    if (this.pendingLogs.length === 0) {\n      return;\n    }\n\n    const logs = this.pendingLogs;\n    this.pendingLogs = [];\n\n    try {\n      await this.sendLogs(logs);\n    } catch (error) {\n      this.pendingLogs = [...logs, ...this.pendingLogs];\n      console.error('[PinoCloudExporter] Failed to flush logs:', error);\n    }\n  }\n\n  private async sendLogs(logRecords: any[]): Promise<void> {\n    await this.ensureJwt();\n\n    const payload = {\n      resourceLogs: [\n        {\n          resource: {\n            attributes: [\n              { key: 'service.name', value: { stringValue: 'livekit-agents' } },\n              { key: 'room_id', value: { stringValue: this.config.roomId } },\n              { key: 'job_id', value: { stringValue: this.config.jobId } },\n            ],\n          },\n          scopeLogs: [\n            {\n              scope: {\n                name: this.loggerName,\n                attributes: [\n                  { key: 'room_id', value: { stringValue: this.config.roomId } },\n                  { key: 'job_id', value: { stringValue: this.config.jobId } },\n                ],\n              },\n              logRecords,\n            },\n          ],\n        },\n      ],\n    };\n\n    const endpoint = `https://${this.config.cloudHostname}/observability/logs/otlp/v0`;\n\n    const response = await fetch(endpoint, {\n      method: 'POST',\n      headers: {\n        Authorization: `Bearer ${this.jwt}`,\n        'Content-Type': 'application/json',\n      },\n      body: JSON.stringify(payload),\n    });\n\n    if (!response.ok) {\n      const text = await response.text();\n      throw new Error(`Log export failed: ${response.status} ${response.statusText} - ${text}`);\n    }\n  }\n\n  private async ensureJwt(): Promise<void> {\n    if (this.jwt) return;\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');\n    }\n\n    const token = new AccessToken(apiKey, apiSecret, { ttl: '6h' });\n    token.addObservabilityGrant({ write: true });\n    this.jwt = await token.toJwt();\n  }\n\n  async shutdown(): Promise<void> {\n    await this.flush();\n  }\n}\n\nlet globalExporter: PinoCloudExporter | null = null;\n\nexport function initPinoCloudExporter(config: PinoCloudExporterConfig): void {\n  globalExporter = new PinoCloudExporter(config);\n}\n\nexport function getPinoCloudExporter(): PinoCloudExporter | null {\n  return globalExporter;\n}\n\nexport function emitToOtel(logObj: PinoLogObject): void {\n  if (globalExporter) {\n    globalExporter.emit(logObj);\n  }\n}\n\nexport async function flushPinoLogs(): Promise<void> {\n  if (globalExporter) {\n    await globalExporter.flush();\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/telemetry/traces.cjs

@@ -1,7 +1,9 @@
 "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)
@@ -15,21 +17,37 @@ var __copyProps = (to, from, except, desc) => {
   }
   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
+  tracer: () => tracer,
+  uploadSessionReport: () => uploadSessionReport
 });
 module.exports = __toCommonJS(traces_exports);
+var import_protocol = require("@livekit/protocol");
 var import_api = require("@opentelemetry/api");
-var import_exporter_trace_otlp_http = require("@opentelemetry/exporter-trace-otlp-http");
+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_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;
@@ -84,19 +102,14 @@ class DynamicTracer {
     const ctx = options.context || import_api.context.active();
     const endOnExit = options.endOnExit === void 0 ? true : options.endOnExit;
     const opts = { attributes: options.attributes };
-    return new Promise((resolve, reject) => {
-      this.tracer.startActiveSpan(options.name, opts, ctx, async (span) => {
-        try {
-          const result = await fn(span);
-          resolve(result);
-        } catch (error) {
-          reject(error);
-        } finally {
-          if (endOnExit) {
-            span.end();
-          }
+    return await this.tracer.startActiveSpan(options.name, opts, ctx, async (span) => {
+      try {
+        return await fn(span);
+      } finally {
+        if (endOnExit) {
+          span.end();
         }
-      });
+      }
     });
   }
   /**
@@ -171,7 +184,7 @@ async function setupCloudTracer(options) {
       room_id: roomId,
       job_id: jobId
     });
-    const spanExporter = new import_exporter_trace_otlp_http.OTLPTraceExporter({
+    const spanExporter = new import_exporter_trace_otlp_proto.OTLPTraceExporter({
       url: `https://${cloudHostname}/observability/traces/otlp/v0`,
       headers,
       compression: import_otlp_exporter_base.CompressionAlgorithm.GZIP
@@ -182,15 +195,211 @@ async function setupCloudTracer(options) {
     });
     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) {
+    let itemTimestamp = item.createdAt;
+    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 headerMsg = new import_protocol.MetricsRecordingHeader({
+    roomId: report.roomId,
+    duration: BigInt(0),
+    // TODO: Calculate actual duration from report
+    startTime: {
+      seconds: BigInt(Math.floor(report.timestamp / 1e3)),
+      nanos: Math.floor(report.timestamp % 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()
+    }
+  });
+  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) {
+          reject(
+            new Error(`Failed to upload session report: ${res.statusCode} ${res.statusMessage}`)
+          );
+          return;
+        }
+        res.resume();
+        res.on("end", () => resolve());
+      }
+    );
+  });
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  flushOtelLogs,
   setTracerProvider,
   setupCloudTracer,
-  tracer
+  tracer,
+  uploadSessionReport
 });
 //# sourceMappingURL=traces.cjs.map

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 {\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 { OTLPTraceExporter } from '@opentelemetry/exporter-trace-otlp-http';\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 { AccessToken } from 'livekit-server-sdk';\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}\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    const span = this.tracer.startSpan(\n      options.name,\n      {\n        attributes: options.attributes,\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 };\n\n    return new Promise((resolve, reject) => {\n      this.tracer.startActiveSpan(options.name, opts, ctx, async (span) => {\n        try {\n          const result = await fn(span);\n          resolve(result);\n        } catch (error) {\n          reject(error);\n        } finally {\n          if (endOnExit) {\n            span.end();\n          }\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 };\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// TODO(brian): PR4 - Add MetadataLogProcessor for structured logging\n\n// TODO(brian): PR4 - Add ExtraDetailsProcessor for structured logging\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    // Metadata processor is already configured in the constructor above\n    setTracerProvider(tracerProvider);\n\n    // TODO(brian): PR4 - Add logger provider setup here for structured logging\n    // Similar to Python's setup: LoggerProvider, OTLPLogExporter, BatchLogRecordProcessor\n  } catch (error) {\n    console.error('Failed to setup cloud tracer:', error);\n    throw error;\n  }\n}\n"],"mappings":"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","names":["otelContext"]}
+{"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 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}\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    const span = this.tracer.startSpan(\n      options.name,\n      {\n        attributes: options.attributes,\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 };\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 };\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    // Ensure monotonically increasing timestamps for proper ordering\n    // Add 0.001ms (1 microsecond) offset when timestamps collide\n    let itemTimestamp = item.createdAt;\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  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 headerMsg = new MetricsRecordingHeader({\n    roomId: report.roomId,\n    duration: BigInt(0), // TODO: Calculate actual duration from report\n    startTime: {\n      seconds: BigInt(Math.floor(report.timestamp / 1000)),\n      nanos: Math.floor((report.timestamp % 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  // TODO(brian): Add audio recording file when recorder IO is implemented\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          reject(\n            new Error(`Failed to upload session report: ${res.statusCode} ${res.statusMessage}`),\n          );\n          return;\n        }\n\n        res.resume(); // Drain the response\n        res.on('end', () => resolve());\n      },\n    );\n  });\n}\n"],"mappings":"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","names":["otelContext","FormData"]}

package/dist/telemetry/traces.d.cts

@@ -1,5 +1,6 @@
 import { type Attributes, type Context, type Span, type Tracer, type TracerProvider } from '@opentelemetry/api';
 import { NodeTracerProvider } from '@opentelemetry/sdk-trace-node';
+import type { SessionReport } from '../voice/report.js';
 export interface StartSpanOptions {
     /** Name of the span */
     name: string;
@@ -93,5 +94,21 @@ export declare function setupCloudTracer(options: {
     jobId: string;
     cloudHostname: string;
 }): Promise<void>;
+/**
+ * Flush all pending Pino logs to ensure they are exported.
+ * Call this before session/job ends to ensure all logs are sent.
+ *
+ * @internal
+ */
+export declare function flushOtelLogs(): Promise<void>;
+/**
+ * Upload session report to LiveKit Cloud observability.
+ * @param options - Configuration with agentName, cloudHostname, and report
+ */
+export declare function uploadSessionReport(options: {
+    agentName: string;
+    cloudHostname: string;
+    report: SessionReport;
+}): Promise<void>;
 export {};
 //# sourceMappingURL=traces.d.ts.map

package/dist/telemetry/traces.d.ts

@@ -1,5 +1,6 @@
 import { type Attributes, type Context, type Span, type Tracer, type TracerProvider } from '@opentelemetry/api';
 import { NodeTracerProvider } from '@opentelemetry/sdk-trace-node';
+import type { SessionReport } from '../voice/report.js';
 export interface StartSpanOptions {
     /** Name of the span */
     name: string;
@@ -93,5 +94,21 @@ export declare function setupCloudTracer(options: {
     jobId: string;
     cloudHostname: string;
 }): Promise<void>;
+/**
+ * Flush all pending Pino logs to ensure they are exported.
+ * Call this before session/job ends to ensure all logs are sent.
+ *
+ * @internal
+ */
+export declare function flushOtelLogs(): Promise<void>;
+/**
+ * Upload session report to LiveKit Cloud observability.
+ * @param options - Configuration with agentName, cloudHostname, and report
+ */
+export declare function uploadSessionReport(options: {
+    agentName: string;
+    cloudHostname: string;
+    report: SessionReport;
+}): Promise<void>;
 export {};
 //# sourceMappingURL=traces.d.ts.map