livekit-agents@1.5.17

Tencent-Hunyuan/HY-Motion-1.0livekit-agents@1.5.17Jun 3, 2026by tinalenguyen

AI Summary

This release focuses on enhancing voice agent capabilities with new model support and stability improvements, including updated STT/TTS models and fixes for recorder hangs.

Key Highlights

  • Added AgentSession.claim_user_turn for voice agent control.
  • Updated model literals for LLM, STT, and TTS with new models and options.
  • Added deployment environment in worker registration.
  • Fixed recorder close hangs and corrupt frame splits.
  • Added Agent ID header to inference requests.

New Features

  • Language option for Gradium STT.
  • AgentSession.claim_user_turn method.
  • New model options for LLM, STT, and TTS.
  • Deployment environment in worker registration.
  • Agent ID header for inference requests.

Full Release Notes

## What's Changed
* feat(gradium STT): add language option to gradium.STT by @FLoppix in https://github.com/livekit/agents/pull/5878
* fix(workflows): bind GetDtmfTask user-state handler to user_state_changed by @u9g in https://github.com/livekit/agents/pull/5900
* fix(examples): check anam_avatar_id in ANAM_AVATAR_ID guard by @u9g in https://github.com/livekit/agents/pull/5901
* test(openai realtime): fix process_base_url assertion that was always passing by @u9g in https://github.com/livekit/agents/pull/5903
* fix(examples): raise ToolError instead of returning it in realtime_joke_teller by @u9g in https://github.com/livekit/agents/pull/5904
* docs(readme): fix syntax errors in StoryAgent and test snippets by @u9g in https://github.com/livekit/agents/pull/5905
* feat(voice): add AgentSession.claim_user_turn by @longcw in https://github.com/livekit/agents/pull/5806
* make claim_user_turn private by @longcw in https://github.com/livekit/agents/pull/5911
* fix(ipc): retry proc acquisition when all in-flight spawns fail by @longcw in https://github.com/livekit/agents/pull/5874
* feat(models): update model literals for LLM, STT, and TTS, adding new models and options by @russellmartin-livekit in https://github.com/livekit/agents/pull/5917
* feat(worker): send deployment environment in worker registration by @theomonnom in https://github.com/livekit/agents/pull/5920
* Dispatch downstream version bumps on stable publish by @Topherhindman in https://github.com/livekit/agents/pull/5817
* livekit-agents@1.5.16 by @github-actions[bot] in https://github.com/livekit/agents/pull/5922
* fix(job): close RecorderIO at session end if session close was interrupted by @longcw in https://github.com/livekit/agents/pull/5927
* fix(recorder): prevent close hang and fix corrupt frame splits by @chenghao-mou in https://github.com/livekit/agents/pull/5926
* feat(examples/avatar): added animation triggers and trimmed personas by @brycedli in https://github.com/livekit/agents/pull/5899
* fix examples deploy by @tinalenguyen in https://github.com/livekit/agents/pull/5939
* revert alphabetized tool ordering by @tinalenguyen in https://github.com/livekit/agents/pull/5941
* fix(amd): start listening on lost publisher, forward realtime transcripts, harden attribute wait by @chenghao-mou in https://github.com/livekit/agents/pull/5918
* feat(inference): Add agent ID header to inference requests by @adrian-cowham in https://github.com/livekit/agents/pull/5937
* feat(worker): add WORKER_PROTOCOL_VERSION and return WorkerInfo from /worker endpoint by @theomonnom in https://github.com/livekit/agents/pull/5923
* fix(inference): don't leak mock participant sid into request headers by @adrian-cowham in https://github.com/livekit/agents/pull/5943
* (speechmatics): remove hard coded confidence  by @tinalenguyen in https://github.com/livekit/agents/pull/5942
* (openai realtime): add reasoning param by @tinalenguyen in https://github.com/livekit/agents/pull/5944
* fix(inference): guard agent sid header against unconnected room by @adrian-cowham in https://github.com/livekit/agents/pull/5947
* livekit-agents@1.5.17 by @github-actions[bot] in https://github.com/livekit/agents/pull/5949

## New Contributors
* @FLoppix made their first contribution in https://github.com/livekit/agents/pull/5878
* @brycedli made their first contribution in https://github.com/livekit/agents/pull/5899

**Full Changelog**: https://github.com/livekit/agents/compare/livekit-agents@1.5.15...livekit-agents@1.5.17