@livekit/agents 1.1.0 → 1.2.0

package/dist/telemetry/index.js

@@ -0,0 +1,37 @@
+import { ExtraDetailsProcessor, MetadataLogProcessor } from "./logging.js";
+import {
+  SimpleOTLPHttpLogExporter
+} from "./otel_http_exporter.js";
+import {
+  emitToOtel,
+  flushPinoLogs,
+  initPinoCloudExporter,
+  PinoCloudExporter
+} from "./pino_otel_transport.js";
+import * as traceTypes from "./trace_types.js";
+import {
+  flushOtelLogs,
+  setTracerProvider,
+  setupCloudTracer,
+  tracer,
+  uploadSessionReport
+} from "./traces.js";
+import { recordException, recordRealtimeMetrics } from "./utils.js";
+export {
+  ExtraDetailsProcessor,
+  MetadataLogProcessor,
+  PinoCloudExporter,
+  SimpleOTLPHttpLogExporter,
+  emitToOtel,
+  flushOtelLogs,
+  flushPinoLogs,
+  initPinoCloudExporter,
+  recordException,
+  recordRealtimeMetrics,
+  setTracerProvider,
+  setupCloudTracer,
+  traceTypes,
+  tracer,
+  uploadSessionReport
+};
+//# sourceMappingURL=index.js.map

package/dist/telemetry/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/telemetry/index.ts"],"sourcesContent":["// SPDX-FileCopyrightText: 2025 LiveKit, Inc.\n//\n// SPDX-License-Identifier: Apache-2.0\n\nexport { ExtraDetailsProcessor, MetadataLogProcessor } from './logging.js';\nexport {\n  SimpleOTLPHttpLogExporter,\n  type SimpleLogRecord,\n  type SimpleOTLPHttpLogExporterConfig,\n} from './otel_http_exporter.js';\nexport {\n  emitToOtel,\n  flushPinoLogs,\n  initPinoCloudExporter,\n  PinoCloudExporter,\n  type PinoCloudExporterConfig,\n  type PinoLogObject,\n} from './pino_otel_transport.js';\nexport * as traceTypes from './trace_types.js';\nexport {\n  flushOtelLogs,\n  setTracerProvider,\n  setupCloudTracer,\n  tracer,\n  uploadSessionReport,\n  type StartSpanOptions,\n} from './traces.js';\nexport { recordException, recordRealtimeMetrics } from './utils.js';\n"],"mappings":"AAIA,SAAS,uBAAuB,4BAA4B;AAC5D;AAAA,EACE;AAAA,OAGK;AACP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OAGK;AACP,YAAY,gBAAgB;AAC5B;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OAEK;AACP,SAAS,iBAAiB,6BAA6B;","names":[]}

package/dist/telemetry/logging.cjs

@@ -0,0 +1,65 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var logging_exports = {};
+__export(logging_exports, {
+  ExtraDetailsProcessor: () => ExtraDetailsProcessor,
+  MetadataLogProcessor: () => MetadataLogProcessor
+});
+module.exports = __toCommonJS(logging_exports);
+class MetadataLogProcessor {
+  metadata;
+  constructor(metadata) {
+    this.metadata = metadata;
+  }
+  onEmit(logRecord) {
+    if (logRecord.attributes) {
+      Object.assign(logRecord.attributes, this.metadata);
+    } else {
+      logRecord.attributes = { ...this.metadata };
+    }
+  }
+  shutdown() {
+    return Promise.resolve();
+  }
+  forceFlush() {
+    return Promise.resolve();
+  }
+}
+class ExtraDetailsProcessor {
+  onEmit(logRecord) {
+    const loggerName = logRecord.instrumentationScope.name;
+    if (logRecord.attributes) {
+      logRecord.attributes["logger.name"] = loggerName;
+    } else {
+      logRecord.attributes = { "logger.name": loggerName };
+    }
+  }
+  shutdown() {
+    return Promise.resolve();
+  }
+  forceFlush() {
+    return Promise.resolve();
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  ExtraDetailsProcessor,
+  MetadataLogProcessor
+});
+//# sourceMappingURL=logging.cjs.map

package/dist/telemetry/logging.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/telemetry/logging.ts"],"sourcesContent":["// SPDX-FileCopyrightText: 2025 LiveKit, Inc.\n//\n// SPDX-License-Identifier: Apache-2.0\nimport type { Attributes } from '@opentelemetry/api';\nimport type { LogRecord, LogRecordProcessor } from '@opentelemetry/sdk-logs';\n\n/**\n * Metadata log processor that injects metadata (room_id, job_id) into all log records.\n */\nexport class MetadataLogProcessor implements LogRecordProcessor {\n  private metadata: Attributes;\n\n  constructor(metadata: Attributes) {\n    this.metadata = metadata;\n  }\n\n  onEmit(logRecord: LogRecord): void {\n    // Add metadata to log record attributes\n    if (logRecord.attributes) {\n      Object.assign(logRecord.attributes, this.metadata);\n    } else {\n      (logRecord as any).attributes = { ...this.metadata };\n    }\n  }\n\n  shutdown(): Promise<void> {\n    return Promise.resolve();\n  }\n\n  forceFlush(): Promise<void> {\n    return Promise.resolve();\n  }\n}\n\n/**\n * Extra details processor that adds logger name to log records.\n */\nexport class ExtraDetailsProcessor implements LogRecordProcessor {\n  onEmit(logRecord: LogRecord): void {\n    const loggerName = logRecord.instrumentationScope.name;\n    if (logRecord.attributes) {\n      (logRecord.attributes as any)['logger.name'] = loggerName;\n    } else {\n      (logRecord as any).attributes = { 'logger.name': loggerName };\n    }\n  }\n\n  shutdown(): Promise<void> {\n    return Promise.resolve();\n  }\n\n  forceFlush(): Promise<void> {\n    return Promise.resolve();\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AASO,MAAM,qBAAmD;AAAA,EACtD;AAAA,EAER,YAAY,UAAsB;AAChC,SAAK,WAAW;AAAA,EAClB;AAAA,EAEA,OAAO,WAA4B;AAEjC,QAAI,UAAU,YAAY;AACxB,aAAO,OAAO,UAAU,YAAY,KAAK,QAAQ;AAAA,IACnD,OAAO;AACL,MAAC,UAAkB,aAAa,EAAE,GAAG,KAAK,SAAS;AAAA,IACrD;AAAA,EACF;AAAA,EAEA,WAA0B;AACxB,WAAO,QAAQ,QAAQ;AAAA,EACzB;AAAA,EAEA,aAA4B;AAC1B,WAAO,QAAQ,QAAQ;AAAA,EACzB;AACF;AAKO,MAAM,sBAAoD;AAAA,EAC/D,OAAO,WAA4B;AACjC,UAAM,aAAa,UAAU,qBAAqB;AAClD,QAAI,UAAU,YAAY;AACxB,MAAC,UAAU,WAAmB,aAAa,IAAI;AAAA,IACjD,OAAO;AACL,MAAC,UAAkB,aAAa,EAAE,eAAe,WAAW;AAAA,IAC9D;AAAA,EACF;AAAA,EAEA,WAA0B;AACxB,WAAO,QAAQ,QAAQ;AAAA,EACzB;AAAA,EAEA,aAA4B;AAC1B,WAAO,QAAQ,QAAQ;AAAA,EACzB;AACF;","names":[]}

package/dist/telemetry/logging.d.cts

@@ -0,0 +1,21 @@
+import type { Attributes } from '@opentelemetry/api';
+import type { LogRecord, LogRecordProcessor } from '@opentelemetry/sdk-logs';
+/**
+ * Metadata log processor that injects metadata (room_id, job_id) into all log records.
+ */
+export declare class MetadataLogProcessor implements LogRecordProcessor {
+    private metadata;
+    constructor(metadata: Attributes);
+    onEmit(logRecord: LogRecord): void;
+    shutdown(): Promise<void>;
+    forceFlush(): Promise<void>;
+}
+/**
+ * Extra details processor that adds logger name to log records.
+ */
+export declare class ExtraDetailsProcessor implements LogRecordProcessor {
+    onEmit(logRecord: LogRecord): void;
+    shutdown(): Promise<void>;
+    forceFlush(): Promise<void>;
+}
+//# sourceMappingURL=logging.d.ts.map

package/dist/telemetry/logging.d.ts

@@ -0,0 +1,21 @@
+import type { Attributes } from '@opentelemetry/api';
+import type { LogRecord, LogRecordProcessor } from '@opentelemetry/sdk-logs';
+/**
+ * Metadata log processor that injects metadata (room_id, job_id) into all log records.
+ */
+export declare class MetadataLogProcessor implements LogRecordProcessor {
+    private metadata;
+    constructor(metadata: Attributes);
+    onEmit(logRecord: LogRecord): void;
+    shutdown(): Promise<void>;
+    forceFlush(): Promise<void>;
+}
+/**
+ * Extra details processor that adds logger name to log records.
+ */
+export declare class ExtraDetailsProcessor implements LogRecordProcessor {
+    onEmit(logRecord: LogRecord): void;
+    shutdown(): Promise<void>;
+    forceFlush(): Promise<void>;
+}
+//# sourceMappingURL=logging.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"logging.d.ts","sourceRoot":"","sources":["../../src/telemetry/logging.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,KAAK,EAAE,SAAS,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAE7E;;GAEG;AACH,qBAAa,oBAAqB,YAAW,kBAAkB;IAC7D,OAAO,CAAC,QAAQ,CAAa;gBAEjB,QAAQ,EAAE,UAAU;IAIhC,MAAM,CAAC,SAAS,EAAE,SAAS,GAAG,IAAI;IASlC,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAIzB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;CAG5B;AAED;;GAEG;AACH,qBAAa,qBAAsB,YAAW,kBAAkB;IAC9D,MAAM,CAAC,SAAS,EAAE,SAAS,GAAG,IAAI;IASlC,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAIzB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;CAG5B"}

package/dist/telemetry/logging.js

@@ -0,0 +1,40 @@
+class MetadataLogProcessor {
+  metadata;
+  constructor(metadata) {
+    this.metadata = metadata;
+  }
+  onEmit(logRecord) {
+    if (logRecord.attributes) {
+      Object.assign(logRecord.attributes, this.metadata);
+    } else {
+      logRecord.attributes = { ...this.metadata };
+    }
+  }
+  shutdown() {
+    return Promise.resolve();
+  }
+  forceFlush() {
+    return Promise.resolve();
+  }
+}
+class ExtraDetailsProcessor {
+  onEmit(logRecord) {
+    const loggerName = logRecord.instrumentationScope.name;
+    if (logRecord.attributes) {
+      logRecord.attributes["logger.name"] = loggerName;
+    } else {
+      logRecord.attributes = { "logger.name": loggerName };
+    }
+  }
+  shutdown() {
+    return Promise.resolve();
+  }
+  forceFlush() {
+    return Promise.resolve();
+  }
+}
+export {
+  ExtraDetailsProcessor,
+  MetadataLogProcessor
+};
+//# sourceMappingURL=logging.js.map

package/dist/telemetry/logging.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/telemetry/logging.ts"],"sourcesContent":["// SPDX-FileCopyrightText: 2025 LiveKit, Inc.\n//\n// SPDX-License-Identifier: Apache-2.0\nimport type { Attributes } from '@opentelemetry/api';\nimport type { LogRecord, LogRecordProcessor } from '@opentelemetry/sdk-logs';\n\n/**\n * Metadata log processor that injects metadata (room_id, job_id) into all log records.\n */\nexport class MetadataLogProcessor implements LogRecordProcessor {\n  private metadata: Attributes;\n\n  constructor(metadata: Attributes) {\n    this.metadata = metadata;\n  }\n\n  onEmit(logRecord: LogRecord): void {\n    // Add metadata to log record attributes\n    if (logRecord.attributes) {\n      Object.assign(logRecord.attributes, this.metadata);\n    } else {\n      (logRecord as any).attributes = { ...this.metadata };\n    }\n  }\n\n  shutdown(): Promise<void> {\n    return Promise.resolve();\n  }\n\n  forceFlush(): Promise<void> {\n    return Promise.resolve();\n  }\n}\n\n/**\n * Extra details processor that adds logger name to log records.\n */\nexport class ExtraDetailsProcessor implements LogRecordProcessor {\n  onEmit(logRecord: LogRecord): void {\n    const loggerName = logRecord.instrumentationScope.name;\n    if (logRecord.attributes) {\n      (logRecord.attributes as any)['logger.name'] = loggerName;\n    } else {\n      (logRecord as any).attributes = { 'logger.name': loggerName };\n    }\n  }\n\n  shutdown(): Promise<void> {\n    return Promise.resolve();\n  }\n\n  forceFlush(): Promise<void> {\n    return Promise.resolve();\n  }\n}\n"],"mappings":"AASO,MAAM,qBAAmD;AAAA,EACtD;AAAA,EAER,YAAY,UAAsB;AAChC,SAAK,WAAW;AAAA,EAClB;AAAA,EAEA,OAAO,WAA4B;AAEjC,QAAI,UAAU,YAAY;AACxB,aAAO,OAAO,UAAU,YAAY,KAAK,QAAQ;AAAA,IACnD,OAAO;AACL,MAAC,UAAkB,aAAa,EAAE,GAAG,KAAK,SAAS;AAAA,IACrD;AAAA,EACF;AAAA,EAEA,WAA0B;AACxB,WAAO,QAAQ,QAAQ;AAAA,EACzB;AAAA,EAEA,aAA4B;AAC1B,WAAO,QAAQ,QAAQ;AAAA,EACzB;AACF;AAKO,MAAM,sBAAoD;AAAA,EAC/D,OAAO,WAA4B;AACjC,UAAM,aAAa,UAAU,qBAAqB;AAClD,QAAI,UAAU,YAAY;AACxB,MAAC,UAAU,WAAmB,aAAa,IAAI;AAAA,IACjD,OAAO;AACL,MAAC,UAAkB,aAAa,EAAE,eAAe,WAAW;AAAA,IAC9D;AAAA,EACF;AAAA,EAEA,WAA0B;AACxB,WAAO,QAAQ,QAAQ;AAAA,EACzB;AAAA,EAEA,aAA4B;AAC1B,WAAO,QAAQ,QAAQ;AAAA,EACzB;AACF;","names":[]}

package/dist/telemetry/otel_http_exporter.cjs

@@ -0,0 +1,166 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var otel_http_exporter_exports = {};
+__export(otel_http_exporter_exports, {
+  SimpleOTLPHttpLogExporter: () => SimpleOTLPHttpLogExporter
+});
+module.exports = __toCommonJS(otel_http_exporter_exports);
+var import_api_logs = require("@opentelemetry/api-logs");
+var import_livekit_server_sdk = require("livekit-server-sdk");
+class SimpleOTLPHttpLogExporter {
+  config;
+  jwt = null;
+  static FORCE_DOUBLE_KEYS = /* @__PURE__ */ new Set([
+    "transcriptConfidence",
+    "transcriptionDelay",
+    "endOfTurnDelay",
+    "onUserTurnCompletedDelay",
+    "llmNodeTtft",
+    "ttsNodeTtfb",
+    "e2eLatency"
+  ]);
+  constructor(config) {
+    this.config = config;
+  }
+  /**
+   * Export simple log records
+   */
+  async export(records) {
+    if (records.length === 0) return;
+    await this.ensureJwt();
+    const endpoint = `https://${this.config.cloudHostname}/observability/logs/otlp/v0`;
+    const payload = this.buildPayload(records);
+    const payloadJson = JSON.stringify(payload);
+    const response = await fetch(endpoint, {
+      method: "POST",
+      headers: {
+        Authorization: `Bearer ${this.jwt}`,
+        "Content-Type": "application/json"
+      },
+      body: payloadJson
+    });
+    if (!response.ok) {
+      const text = await response.text();
+      throw new Error(
+        `OTLP 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 import_livekit_server_sdk.AccessToken(apiKey, apiSecret, { ttl: "6h" });
+    token.addObservabilityGrant({ write: true });
+    this.jwt = await token.toJwt();
+  }
+  buildPayload(records) {
+    const resourceAttrs = Object.entries(this.config.resourceAttributes).map(([key, value]) => ({
+      key,
+      value: { stringValue: value }
+    }));
+    if (!this.config.resourceAttributes["service.name"]) {
+      resourceAttrs.push({ key: "service.name", value: { stringValue: "livekit-agents" } });
+    }
+    const scopeAttrs = this.config.scopeAttributes ? Object.entries(this.config.scopeAttributes).map(([key, value]) => ({
+      key,
+      value: { stringValue: value }
+    })) : [];
+    const logRecords = records.map((record) => {
+      const timestampMs = Number.isFinite(record.timestampMs) ? record.timestampMs : Date.now();
+      return {
+        timeUnixNano: String(BigInt(Math.floor(timestampMs * 1e6))),
+        observedTimeUnixNano: String(BigInt(Date.now()) * BigInt(1e6)),
+        severityNumber: record.severityNumber ?? import_api_logs.SeverityNumber.UNSPECIFIED,
+        severityText: record.severityText ?? "unspecified",
+        body: { stringValue: record.body },
+        attributes: this.convertAttributes(record.attributes),
+        traceId: "",
+        spanId: ""
+      };
+    });
+    return {
+      resourceLogs: [
+        {
+          resource: { attributes: resourceAttrs },
+          scopeLogs: [
+            {
+              scope: {
+                name: this.config.scopeName,
+                attributes: scopeAttrs
+              },
+              logRecords
+            }
+          ]
+        }
+      ]
+    };
+  }
+  convertAttributes(attrs) {
+    return Object.entries(attrs).map(([key, value]) => ({
+      key,
+      value: this.convertValue(value, key)
+    }));
+  }
+  convertValue(value, path = "") {
+    var _a;
+    if (value === null || value === void 0) {
+      return { stringValue: "" };
+    }
+    if (typeof value === "string") {
+      return { stringValue: value };
+    }
+    if (typeof value === "number") {
+      const leafKey = ((_a = path.split(".").pop()) == null ? void 0 : _a.replace(/\[\d+\]$/, "")) ?? path;
+      if (SimpleOTLPHttpLogExporter.FORCE_DOUBLE_KEYS.has(leafKey)) {
+        return { doubleValue: value };
+      }
+      return Number.isInteger(value) ? { intValue: String(value) } : { doubleValue: value };
+    }
+    if (typeof value === "boolean") {
+      return { boolValue: value };
+    }
+    if (Array.isArray(value)) {
+      return {
+        arrayValue: {
+          values: value.map((v, i) => this.convertValue(v, `${path}[${i}]`))
+        }
+      };
+    }
+    if (typeof value === "object") {
+      return {
+        kvlistValue: {
+          values: Object.entries(value).map(([k, v]) => ({
+            key: k,
+            value: this.convertValue(v, path ? `${path}.${k}` : k)
+          }))
+        }
+      };
+    }
+    return { stringValue: String(value) };
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  SimpleOTLPHttpLogExporter
+});
+//# sourceMappingURL=otel_http_exporter.cjs.map

package/dist/telemetry/otel_http_exporter.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/telemetry/otel_http_exporter.ts"],"sourcesContent":["// SPDX-FileCopyrightText: 2025 LiveKit, Inc.\n//\n// SPDX-License-Identifier: Apache-2.0\n\n/**\n * OTLP HTTP JSON Log Exporter for LiveKit Cloud\n *\n * This module provides a custom OTLP log exporter that uses HTTP with JSON format\n * instead of the default protobuf format.\n */\nimport { SeverityNumber } from '@opentelemetry/api-logs';\nimport { AccessToken } from 'livekit-server-sdk';\n\nexport interface SimpleLogRecord {\n  /** Log message body */\n  body: string;\n  /** Timestamp in milliseconds since epoch */\n  timestampMs: number;\n  /** Log attributes */\n  attributes: Record<string, unknown>;\n  /** Severity number (default: UNSPECIFIED) */\n  severityNumber?: SeverityNumber;\n  /** Severity text (default: 'unspecified') */\n  severityText?: string;\n}\n\nexport interface SimpleOTLPHttpLogExporterConfig {\n  /** LiveKit Cloud hostname */\n  cloudHostname: string;\n  /** Resource attributes (e.g., room_id, job_id) */\n  resourceAttributes: Record<string, string>;\n  /** Scope name for the logger */\n  scopeName: string;\n  /** Scope attributes */\n  scopeAttributes?: Record<string, string>;\n}\n\n/**\n * Simple OTLP HTTP Log Exporter for direct log export\n *\n * This is a simplified exporter that doesn't require the full SDK infrastructure.\n * Use this when you need to send logs directly without LoggerProvider.\n *\n * @example\n * ```typescript\n * const exporter = new SimpleOTLPHttpLogExporter({\n *   cloudHostname: 'cloud.livekit.io',\n *   resourceAttributes: { room_id: 'xxx', job_id: 'yyy' },\n *   scopeName: 'chat_history',\n * });\n *\n * await exporter.export([\n *   { body: 'Hello', timestampMs: Date.now(), attributes: { test: true } },\n * ]);\n * ```\n */\nexport class SimpleOTLPHttpLogExporter {\n  private readonly config: SimpleOTLPHttpLogExporterConfig;\n  private jwt: string | null = null;\n\n  private static readonly FORCE_DOUBLE_KEYS = new Set([\n    'transcriptConfidence',\n    'transcriptionDelay',\n    'endOfTurnDelay',\n    'onUserTurnCompletedDelay',\n    'llmNodeTtft',\n    'ttsNodeTtfb',\n    'e2eLatency',\n  ]);\n\n  constructor(config: SimpleOTLPHttpLogExporterConfig) {\n    this.config = config;\n  }\n\n  /**\n   * Export simple log records\n   */\n  async export(records: SimpleLogRecord[]): Promise<void> {\n    if (records.length === 0) return;\n\n    await this.ensureJwt();\n\n    const endpoint = `https://${this.config.cloudHostname}/observability/logs/otlp/v0`;\n    const payload = this.buildPayload(records);\n    const payloadJson = JSON.stringify(payload);\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: payloadJson,\n    });\n\n    if (!response.ok) {\n      const text = await response.text();\n      throw new Error(\n        `OTLP log export failed: ${response.status} ${response.statusText} - ${text}`,\n      );\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  private buildPayload(records: SimpleLogRecord[]): object {\n    const resourceAttrs = Object.entries(this.config.resourceAttributes).map(([key, value]) => ({\n      key,\n      value: { stringValue: value },\n    }));\n\n    if (!this.config.resourceAttributes['service.name']) {\n      resourceAttrs.push({ key: 'service.name', value: { stringValue: 'livekit-agents' } });\n    }\n\n    const scopeAttrs = this.config.scopeAttributes\n      ? Object.entries(this.config.scopeAttributes).map(([key, value]) => ({\n          key,\n          value: { stringValue: value },\n        }))\n      : [];\n\n    const logRecords = records.map((record) => {\n      // Ensure timestampMs is a valid number, fallback to current time if NaN/undefined\n      const timestampMs = Number.isFinite(record.timestampMs) ? record.timestampMs : Date.now();\n      return {\n        timeUnixNano: String(BigInt(Math.floor(timestampMs * 1_000_000))),\n        observedTimeUnixNano: String(BigInt(Date.now()) * BigInt(1_000_000)),\n        severityNumber: record.severityNumber ?? SeverityNumber.UNSPECIFIED,\n        severityText: record.severityText ?? 'unspecified',\n        body: { stringValue: record.body },\n        attributes: this.convertAttributes(record.attributes),\n        traceId: '',\n        spanId: '',\n      };\n    });\n\n    return {\n      resourceLogs: [\n        {\n          resource: { attributes: resourceAttrs },\n          scopeLogs: [\n            {\n              scope: {\n                name: this.config.scopeName,\n                attributes: scopeAttrs,\n              },\n              logRecords,\n            },\n          ],\n        },\n      ],\n    };\n  }\n\n  private convertAttributes(\n    attrs: Record<string, unknown>,\n  ): Array<{ key: string; value: unknown }> {\n    return Object.entries(attrs).map(([key, value]) => ({\n      key,\n      value: this.convertValue(value, key),\n    }));\n  }\n\n  private convertValue(value: unknown, path: string = ''): 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      const leafKey =\n        path\n          .split('.')\n          .pop()\n          ?.replace(/\\[\\d+\\]$/, '') ?? path;\n      if (SimpleOTLPHttpLogExporter.FORCE_DOUBLE_KEYS.has(leafKey)) {\n        return { doubleValue: value };\n      }\n      return Number.isInteger(value) ? { intValue: String(value) } : { doubleValue: value };\n    }\n    if (typeof value === 'boolean') {\n      return { boolValue: value };\n    }\n    if (Array.isArray(value)) {\n      return {\n        arrayValue: {\n          values: value.map((v, i) => this.convertValue(v, `${path}[${i}]`)),\n        },\n      };\n    }\n    if (typeof value === 'object') {\n      return {\n        kvlistValue: {\n          values: Object.entries(value as Record<string, unknown>).map(([k, v]) => ({\n            key: k,\n            value: this.convertValue(v, path ? `${path}.${k}` : k),\n          })),\n        },\n      };\n    }\n    return { stringValue: String(value) };\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/telemetry/otel_http_exporter.d.cts

@@ -0,0 +1,63 @@
+/**
+ * OTLP HTTP JSON Log Exporter for LiveKit Cloud
+ *
+ * This module provides a custom OTLP log exporter that uses HTTP with JSON format
+ * instead of the default protobuf format.
+ */
+import { SeverityNumber } from '@opentelemetry/api-logs';
+export interface SimpleLogRecord {
+    /** Log message body */
+    body: string;
+    /** Timestamp in milliseconds since epoch */
+    timestampMs: number;
+    /** Log attributes */
+    attributes: Record<string, unknown>;
+    /** Severity number (default: UNSPECIFIED) */
+    severityNumber?: SeverityNumber;
+    /** Severity text (default: 'unspecified') */
+    severityText?: string;
+}
+export interface SimpleOTLPHttpLogExporterConfig {
+    /** LiveKit Cloud hostname */
+    cloudHostname: string;
+    /** Resource attributes (e.g., room_id, job_id) */
+    resourceAttributes: Record<string, string>;
+    /** Scope name for the logger */
+    scopeName: string;
+    /** Scope attributes */
+    scopeAttributes?: Record<string, string>;
+}
+/**
+ * Simple OTLP HTTP Log Exporter for direct log export
+ *
+ * This is a simplified exporter that doesn't require the full SDK infrastructure.
+ * Use this when you need to send logs directly without LoggerProvider.
+ *
+ * @example
+ * ```typescript
+ * const exporter = new SimpleOTLPHttpLogExporter({
+ *   cloudHostname: 'cloud.livekit.io',
+ *   resourceAttributes: { room_id: 'xxx', job_id: 'yyy' },
+ *   scopeName: 'chat_history',
+ * });
+ *
+ * await exporter.export([
+ *   { body: 'Hello', timestampMs: Date.now(), attributes: { test: true } },
+ * ]);
+ * ```
+ */
+export declare class SimpleOTLPHttpLogExporter {
+    private readonly config;
+    private jwt;
+    private static readonly FORCE_DOUBLE_KEYS;
+    constructor(config: SimpleOTLPHttpLogExporterConfig);
+    /**
+     * Export simple log records
+     */
+    export(records: SimpleLogRecord[]): Promise<void>;
+    private ensureJwt;
+    private buildPayload;
+    private convertAttributes;
+    private convertValue;
+}
+//# sourceMappingURL=otel_http_exporter.d.ts.map

package/dist/telemetry/otel_http_exporter.d.ts

@@ -0,0 +1,63 @@
+/**
+ * OTLP HTTP JSON Log Exporter for LiveKit Cloud
+ *
+ * This module provides a custom OTLP log exporter that uses HTTP with JSON format
+ * instead of the default protobuf format.
+ */
+import { SeverityNumber } from '@opentelemetry/api-logs';
+export interface SimpleLogRecord {
+    /** Log message body */
+    body: string;
+    /** Timestamp in milliseconds since epoch */
+    timestampMs: number;
+    /** Log attributes */
+    attributes: Record<string, unknown>;
+    /** Severity number (default: UNSPECIFIED) */
+    severityNumber?: SeverityNumber;
+    /** Severity text (default: 'unspecified') */
+    severityText?: string;
+}
+export interface SimpleOTLPHttpLogExporterConfig {
+    /** LiveKit Cloud hostname */
+    cloudHostname: string;
+    /** Resource attributes (e.g., room_id, job_id) */
+    resourceAttributes: Record<string, string>;
+    /** Scope name for the logger */
+    scopeName: string;
+    /** Scope attributes */
+    scopeAttributes?: Record<string, string>;
+}
+/**
+ * Simple OTLP HTTP Log Exporter for direct log export
+ *
+ * This is a simplified exporter that doesn't require the full SDK infrastructure.
+ * Use this when you need to send logs directly without LoggerProvider.
+ *
+ * @example
+ * ```typescript
+ * const exporter = new SimpleOTLPHttpLogExporter({
+ *   cloudHostname: 'cloud.livekit.io',
+ *   resourceAttributes: { room_id: 'xxx', job_id: 'yyy' },
+ *   scopeName: 'chat_history',
+ * });
+ *
+ * await exporter.export([
+ *   { body: 'Hello', timestampMs: Date.now(), attributes: { test: true } },
+ * ]);
+ * ```
+ */
+export declare class SimpleOTLPHttpLogExporter {
+    private readonly config;
+    private jwt;
+    private static readonly FORCE_DOUBLE_KEYS;
+    constructor(config: SimpleOTLPHttpLogExporterConfig);
+    /**
+     * Export simple log records
+     */
+    export(records: SimpleLogRecord[]): Promise<void>;
+    private ensureJwt;
+    private buildPayload;
+    private convertAttributes;
+    private convertValue;
+}
+//# sourceMappingURL=otel_http_exporter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"otel_http_exporter.d.ts","sourceRoot":"","sources":["../../src/telemetry/otel_http_exporter.ts"],"names":[],"mappings":"AAIA;;;;;GAKG;AACH,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAGzD,MAAM,WAAW,eAAe;IAC9B,uBAAuB;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,4CAA4C;IAC5C,WAAW,EAAE,MAAM,CAAC;IACpB,qBAAqB;IACrB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpC,6CAA6C;IAC7C,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,6CAA6C;IAC7C,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,+BAA+B;IAC9C,6BAA6B;IAC7B,aAAa,EAAE,MAAM,CAAC;IACtB,kDAAkD;IAClD,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC3C,gCAAgC;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,uBAAuB;IACvB,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC1C;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,yBAAyB;IACpC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAkC;IACzD,OAAO,CAAC,GAAG,CAAuB;IAElC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,iBAAiB,CAQtC;gBAES,MAAM,EAAE,+BAA+B;IAInD;;OAEG;IACG,MAAM,CAAC,OAAO,EAAE,eAAe,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;YA0BzC,SAAS;IAevB,OAAO,CAAC,YAAY;IAkDpB,OAAO,CAAC,iBAAiB;IASzB,OAAO,CAAC,YAAY;CAwCrB"}

package/dist/telemetry/otel_http_exporter.js

@@ -0,0 +1,142 @@
+import { SeverityNumber } from "@opentelemetry/api-logs";
+import { AccessToken } from "livekit-server-sdk";
+class SimpleOTLPHttpLogExporter {
+  config;
+  jwt = null;
+  static FORCE_DOUBLE_KEYS = /* @__PURE__ */ new Set([
+    "transcriptConfidence",
+    "transcriptionDelay",
+    "endOfTurnDelay",
+    "onUserTurnCompletedDelay",
+    "llmNodeTtft",
+    "ttsNodeTtfb",
+    "e2eLatency"
+  ]);
+  constructor(config) {
+    this.config = config;
+  }
+  /**
+   * Export simple log records
+   */
+  async export(records) {
+    if (records.length === 0) return;
+    await this.ensureJwt();
+    const endpoint = `https://${this.config.cloudHostname}/observability/logs/otlp/v0`;
+    const payload = this.buildPayload(records);
+    const payloadJson = JSON.stringify(payload);
+    const response = await fetch(endpoint, {
+      method: "POST",
+      headers: {
+        Authorization: `Bearer ${this.jwt}`,
+        "Content-Type": "application/json"
+      },
+      body: payloadJson
+    });
+    if (!response.ok) {
+      const text = await response.text();
+      throw new Error(
+        `OTLP 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();
+  }
+  buildPayload(records) {
+    const resourceAttrs = Object.entries(this.config.resourceAttributes).map(([key, value]) => ({
+      key,
+      value: { stringValue: value }
+    }));
+    if (!this.config.resourceAttributes["service.name"]) {
+      resourceAttrs.push({ key: "service.name", value: { stringValue: "livekit-agents" } });
+    }
+    const scopeAttrs = this.config.scopeAttributes ? Object.entries(this.config.scopeAttributes).map(([key, value]) => ({
+      key,
+      value: { stringValue: value }
+    })) : [];
+    const logRecords = records.map((record) => {
+      const timestampMs = Number.isFinite(record.timestampMs) ? record.timestampMs : Date.now();
+      return {
+        timeUnixNano: String(BigInt(Math.floor(timestampMs * 1e6))),
+        observedTimeUnixNano: String(BigInt(Date.now()) * BigInt(1e6)),
+        severityNumber: record.severityNumber ?? SeverityNumber.UNSPECIFIED,
+        severityText: record.severityText ?? "unspecified",
+        body: { stringValue: record.body },
+        attributes: this.convertAttributes(record.attributes),
+        traceId: "",
+        spanId: ""
+      };
+    });
+    return {
+      resourceLogs: [
+        {
+          resource: { attributes: resourceAttrs },
+          scopeLogs: [
+            {
+              scope: {
+                name: this.config.scopeName,
+                attributes: scopeAttrs
+              },
+              logRecords
+            }
+          ]
+        }
+      ]
+    };
+  }
+  convertAttributes(attrs) {
+    return Object.entries(attrs).map(([key, value]) => ({
+      key,
+      value: this.convertValue(value, key)
+    }));
+  }
+  convertValue(value, path = "") {
+    var _a;
+    if (value === null || value === void 0) {
+      return { stringValue: "" };
+    }
+    if (typeof value === "string") {
+      return { stringValue: value };
+    }
+    if (typeof value === "number") {
+      const leafKey = ((_a = path.split(".").pop()) == null ? void 0 : _a.replace(/\[\d+\]$/, "")) ?? path;
+      if (SimpleOTLPHttpLogExporter.FORCE_DOUBLE_KEYS.has(leafKey)) {
+        return { doubleValue: value };
+      }
+      return Number.isInteger(value) ? { intValue: String(value) } : { doubleValue: value };
+    }
+    if (typeof value === "boolean") {
+      return { boolValue: value };
+    }
+    if (Array.isArray(value)) {
+      return {
+        arrayValue: {
+          values: value.map((v, i) => this.convertValue(v, `${path}[${i}]`))
+        }
+      };
+    }
+    if (typeof value === "object") {
+      return {
+        kvlistValue: {
+          values: Object.entries(value).map(([k, v]) => ({
+            key: k,
+            value: this.convertValue(v, path ? `${path}.${k}` : k)
+          }))
+        }
+      };
+    }
+    return { stringValue: String(value) };
+  }
+}
+export {
+  SimpleOTLPHttpLogExporter
+};
+//# sourceMappingURL=otel_http_exporter.js.map