@livekit/agents@1.8.0

Minor Changes

• Emit the full OpenTelemetry GenAI semantic conventions on agent spans. - #2411 (@theomonnom)

  Spans now carry the standard gen_ai.* attributes — operation, provider, request/response
  model, per-modality token usage, cached tokens, finish reasons, time-to-first-chunk, tool
  name/type/call id, and the gen_ai.input.messages / gen_ai.output.messages /
  gen_ai.system_instructions / gen_ai.tool.definitions content payloads — so Datadog Agent
  Observability, Langfuse and any other backend that reads the conventions (OTel v1.37+)
  renders a LiveKit trace without a custom mapping. The session maps to invoke_workflow, an
  agent turn to invoke_agent, inference to chat (realtime turns to generate_content on
  their own nested span), and tool execution to execute_tool.

  gen_ai.provider.name now reports the registry spelling the convention requires. Plugins
  expose provider either as a display name (MistralAI, AWS Bedrock, Vertex AI) or as the
  client's base-URL host (api.openai.com, api.anthropic.com); both are normalized, so
  openai, anthropic, mistral_ai, aws.bedrock, gcp.vertex_ai, gcp.gemini, x_ai,
  groq and perplexity are recognized by GenAI backends. A provider outside the registry
  keeps its own id, which the convention allows.

  Conversational content reaches every configured exporter, as before. To withhold it from a
  third-party pipeline while LiveKit Cloud keeps receiving it, pass allowPii: false:

  telemetry.setTracerProvider(provider, { registerSpanProcessor, allowPii: false });

  or set LIVEKIT_TELEMETRY_ALLOW_PII=0 when the framework adopts the ambient OpenTelemetry
  provider and there is no call site. What LiveKit Cloud receives stays governed by the
  project's PII setting in the dashboard; when that mandates redaction, PII is withheld from
  every destination and allowPii does not weaken it. Content can be dropped entirely with
  telemetry.genAI.setCaptureContent(false) or
  OTEL_INSTRUMENTATION_GENAI_CAPTURE_MESSAGE_CONTENT=false.

Patch Changes

• Handle microphone track replacement for an existing RoomIO publication. - #2363 (@rosetta-livekit-bot)

• Retry connection pool prewarming after a previous attempt fails or completes. - #2378 (@rosetta-livekit-bot)

• fix(voice): cancel a parked preemptive generation when pausing speech scheduling so agent handoffs cannot deadlock - #2398 (@rosetta-livekit-bot)

• fix(voice): cancel a speech that scheduleSpeech refuses while scheduling is paused, so its speech task does not stay parked and block the next drain()/pause() and AgentSession.close() - #2372 (@chenghao-mou)

• Add an onSessionEnd lifecycle callback and configurable timeout before internal session report cleanup. Flush final OTEL logs after shutdown callbacks with a bounded timeout. Apply Python's connection, total, and retry policy to session report uploads. - #2387 (@chenghao-mou)

  Wait for session report cleanup before applying the process shutdown timeout, force-stop jobs that exceed memory limits, preserve logs queued during a final flush, and keep cleanup details and session metadata safe for logging.

  Honour LIVEKIT_OBSERVABILITY_URL when resolving the observability endpoint, keeping the override's scheme, port, and base path so a plaintext or non-default-port collector is reachable.

  The telemetry exporters now take observabilityUrl (a full base URL) in place of cloudHostname (a bare host that always implied https). cloudHostname is deprecated but still accepted on setupCloudTracer, uploadSessionReport, SimpleOTLPHttpLogExporterConfig, and PinoCloudExporterConfig, and resolves to the same endpoint as before.

• Preserve wired VAD speech-end anchors when reporting transcription delay, expose absolute STT speech-end timing, and restore default-VAD speaking state for false-interruption recovery. - #2382 (@rosetta-livekit-bot)

• Preserve non-ASCII characters in pretty logs on Windows terminals. - #2367 (@chenghao-mou)

• Ignore late adaptive interruption responses after the agent speech that requested them ends. - #2417 (@chenghao-mou)

• Text-mode simulation jobs now send X-LiveKit-Inference-Priority: low on every inference request, overriding the model's configured inferenceClass, so simulation runs are paced into spare quota instead of competing with live voice traffic. Matches the Python SDK. - #2423 (@u9g)

• Redact API keys from rejected WebSocket handshake errors. - #2379 (@rosetta-livekit-bot)

• Fix WarmTransferTask hanging after a failed participant move when the human agent disconnects. - #2361 (@chenghao-mou)

• Remove retired ElevenLabs models from LiveKit Inference STT and TTS. - #2415 (@chenghao-mou)

• Close LiveKit Inference STT sessions and sockets when input ends, include the model in WebSocket dials, and stop retrying gateway inactivity closures. - #2413 (@chenghao-mou)

• Surface inference gateway status errors from WebSocket handshakes and active STT sessions. - #2412 (@chenghao-mou)

• Exclude active agent speech from pauses learned by dynamic endpointing. - #2422 (@rosetta-livekit-bot)

• Support Mistral Conversations requests when the chat context ends with an assistant message. - #2376 (@rosetta-livekit-bot)

• Timestamp say() transcripts when speech starts so interrupted turns remain chronologically ordered. - #2421 (@rosetta-livekit-bot)

• RoomIO now preserves a pre-set session.input.audio and session.output.transcription instead of silently replacing them, matching the existing behavior for session.output.audio and the python implementation. - #2296 (@1egoman)