@livekit/agents 1.1.0 → 1.2.1

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

package/dist/telemetry/otel_http_exporter.js.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/pino_otel_transport.cjs

@@ -0,0 +1,217 @@
+"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 pino_otel_transport_exports = {};
+__export(pino_otel_transport_exports, {
+  PinoCloudExporter: () => PinoCloudExporter,
+  emitToOtel: () => emitToOtel,
+  flushPinoLogs: () => flushPinoLogs,
+  getPinoCloudExporter: () => getPinoCloudExporter,
+  initPinoCloudExporter: () => initPinoCloudExporter
+});
+module.exports = __toCommonJS(pino_otel_transport_exports);
+var import_api_logs = require("@opentelemetry/api-logs");
+var import_livekit_server_sdk = require("livekit-server-sdk");
+function mapPinoLevelToSeverity(pinoLevel) {
+  if (pinoLevel <= 10) {
+    return { severityNumber: import_api_logs.SeverityNumber.TRACE, severityText: "TRACE" };
+  } else if (pinoLevel <= 20) {
+    return { severityNumber: import_api_logs.SeverityNumber.DEBUG, severityText: "DEBUG" };
+  } else if (pinoLevel <= 30) {
+    return { severityNumber: import_api_logs.SeverityNumber.INFO, severityText: "INFO" };
+  } else if (pinoLevel <= 40) {
+    return { severityNumber: import_api_logs.SeverityNumber.WARN, severityText: "WARN" };
+  } else if (pinoLevel <= 50) {
+    return { severityNumber: import_api_logs.SeverityNumber.ERROR, severityText: "ERROR" };
+  } else {
+    return { severityNumber: import_api_logs.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 import_livekit_server_sdk.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();
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  PinoCloudExporter,
+  emitToOtel,
+  flushPinoLogs,
+  getPinoCloudExporter,
+  initPinoCloudExporter
+});
+//# sourceMappingURL=pino_otel_transport.cjs.map

package/dist/telemetry/pino_otel_transport.cjs.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/pino_otel_transport.d.cts

@@ -0,0 +1,58 @@
+export interface PinoLogObject {
+    level: number;
+    time: number;
+    msg: string;
+    pid?: number;
+    hostname?: string;
+    [key: string]: unknown;
+}
+export interface PinoCloudExporterConfig {
+    cloudHostname: string;
+    roomId: string;
+    jobId: string;
+    loggerName?: string;
+    batchSize?: number;
+    flushIntervalMs?: number;
+}
+/**
+ * Standalone Pino log exporter for LiveKit Cloud.
+ *
+ * Collects Pino logs, batches them, and sends via raw HTTP JSON.
+ * No OTEL SDK dependency
+ *
+ * @example
+ * ```typescript
+ * const exporter = new PinoCloudExporter({
+ *   cloudHostname: 'cloud.livekit.io',
+ *   roomId: 'RM_xxx',
+ *   jobId: 'AJ_xxx',
+ * });
+ *
+ * // In Pino formatter hook:
+ * exporter.emit(logObj);
+ *
+ * // On session end:
+ * await exporter.flush();
+ * ```
+ */
+export declare class PinoCloudExporter {
+    private readonly config;
+    private readonly loggerName;
+    private readonly batchSize;
+    private readonly flushIntervalMs;
+    private jwt;
+    private pendingLogs;
+    private flushTimer;
+    constructor(config: PinoCloudExporterConfig);
+    emit(logObj: PinoLogObject): void;
+    private convertToOtlpRecord;
+    flush(): Promise<void>;
+    private sendLogs;
+    private ensureJwt;
+    shutdown(): Promise<void>;
+}
+export declare function initPinoCloudExporter(config: PinoCloudExporterConfig): void;
+export declare function getPinoCloudExporter(): PinoCloudExporter | null;
+export declare function emitToOtel(logObj: PinoLogObject): void;
+export declare function flushPinoLogs(): Promise<void>;
+//# sourceMappingURL=pino_otel_transport.d.ts.map

package/dist/telemetry/pino_otel_transport.d.ts

@@ -0,0 +1,58 @@
+export interface PinoLogObject {
+    level: number;
+    time: number;
+    msg: string;
+    pid?: number;
+    hostname?: string;
+    [key: string]: unknown;
+}
+export interface PinoCloudExporterConfig {
+    cloudHostname: string;
+    roomId: string;
+    jobId: string;
+    loggerName?: string;
+    batchSize?: number;
+    flushIntervalMs?: number;
+}
+/**
+ * Standalone Pino log exporter for LiveKit Cloud.
+ *
+ * Collects Pino logs, batches them, and sends via raw HTTP JSON.
+ * No OTEL SDK dependency
+ *
+ * @example
+ * ```typescript
+ * const exporter = new PinoCloudExporter({
+ *   cloudHostname: 'cloud.livekit.io',
+ *   roomId: 'RM_xxx',
+ *   jobId: 'AJ_xxx',
+ * });
+ *
+ * // In Pino formatter hook:
+ * exporter.emit(logObj);
+ *
+ * // On session end:
+ * await exporter.flush();
+ * ```
+ */
+export declare class PinoCloudExporter {
+    private readonly config;
+    private readonly loggerName;
+    private readonly batchSize;
+    private readonly flushIntervalMs;
+    private jwt;
+    private pendingLogs;
+    private flushTimer;
+    constructor(config: PinoCloudExporterConfig);
+    emit(logObj: PinoLogObject): void;
+    private convertToOtlpRecord;
+    flush(): Promise<void>;
+    private sendLogs;
+    private ensureJwt;
+    shutdown(): Promise<void>;
+}
+export declare function initPinoCloudExporter(config: PinoCloudExporterConfig): void;
+export declare function getPinoCloudExporter(): PinoCloudExporter | null;
+export declare function emitToOtel(logObj: PinoLogObject): void;
+export declare function flushPinoLogs(): Promise<void>;
+//# sourceMappingURL=pino_otel_transport.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pino_otel_transport.d.ts","sourceRoot":"","sources":["../../src/telemetry/pino_otel_transport.ts"],"names":[],"mappings":"AAaA,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,uBAAuB;IACtC,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AA0CD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA0B;IACjD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAS;IACzC,OAAO,CAAC,GAAG,CAAuB;IAClC,OAAO,CAAC,WAAW,CAAa;IAChC,OAAO,CAAC,UAAU,CAA+B;gBAErC,MAAM,EAAE,uBAAuB;IAO3C,IAAI,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI;IAejC,OAAO,CAAC,mBAAmB;IAkCrB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;YAqBd,QAAQ;YA8CR,SAAS;IAejB,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAGhC;AAID,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,uBAAuB,GAAG,IAAI,CAE3E;AAED,wBAAgB,oBAAoB,IAAI,iBAAiB,GAAG,IAAI,CAE/D;AAED,wBAAgB,UAAU,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI,CAItD;AAED,wBAAsB,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC,CAInD"}