livekit-agents@1.3.1

livekit/agentslivekit-agents@1.3.1Nov 17, 2025by theomonnom

AI Summary

A bug fix release consolidating changes from the 1.3.x cycle, focusing on CLI fixes, observability, and compatibility.

Key Highlights

  • Added Agent.id attribute.
  • Added AgentHandoff to chat_ctx and AgentSessionReport.
  • Support for GPT-5.1.
  • Improved observability and metrics logging.

New Features

  • Agent.id attribute
  • AgentHandoff integration
  • GPT-5.1 support

Full Release Notes

> [!NOTE]
> A more detailed changelog will be available soon!

## What's Changed
* feat: new CLI & new AgentServer API by @theomonnom in https://github.com/livekit/agents/pull/3199
* remove unused code & fix ServerEnvOption by @theomonnom in https://github.com/livekit/agents/pull/3220
* remove custom excepthook by @theomonnom in https://github.com/livekit/agents/pull/3221
* fix python 3.9 by @theomonnom in https://github.com/livekit/agents/pull/3222
* fix invalid `LogLevel` on the CLI by @theomonnom in https://github.com/livekit/agents/pull/3292
* add `Agent.id` by @theomonnom in https://github.com/livekit/agents/pull/3478
* add `AgentHandoff` chat item by @theomonnom in https://github.com/livekit/agents/pull/3479
* Add `AgentHandoff` to the chat_ctx & AgentSessionReport by @theomonnom in https://github.com/livekit/agents/pull/3541
* fix cli `readchar` by @theomonnom in https://github.com/livekit/agents/pull/3542
* fix `RecorderIO` av.error.MemoryError by @theomonnom in https://github.com/livekit/agents/pull/3543
* fix record & save to tempfile by @theomonnom in https://github.com/livekit/agents/pull/3544
* save session json report when `--record` is enabled by @theomonnom in https://github.com/livekit/agents/pull/3572
* brianyin/agt-1947-automatically-parse-dtmf-input-from-users by @toubatbrian in https://github.com/livekit/agents/pull/3512
* ingest data to cloud by @theomonnom in https://github.com/livekit/agents/pull/3609
* fix Audio/Video input source attach by @theomonnom in https://github.com/livekit/agents/pull/3615
* Allow Recording Verbal DTMF Input when ask_confirmation is turned off by @toubatbrian in https://github.com/livekit/agents/pull/3607
* Agent IVR System Example by @toubatbrian in https://github.com/livekit/agents/pull/3610
* add `ChatContext.summarize` by @theomonnom in https://github.com/livekit/agents/pull/3660
* Gather DTMF Minor Bug Fix by @toubatbrian in https://github.com/livekit/agents/pull/3672
* brianyin/agt-2076-support-repeat-instruction-in-dtmf-gathering by @toubatbrian in https://github.com/livekit/agents/pull/3674
* rename `assistant` to `agent` by @theomonnom in https://github.com/livekit/agents/pull/3690
* TaskGroup by @tinalenguyen in https://github.com/livekit/agents/pull/3680
* ignore on_enter on GetEmailTask by @theomonnom in https://github.com/livekit/agents/pull/3691
* Refactor mock session utilities into a separate file by @toubatbrian in https://github.com/livekit/agents/pull/3692
* fix _MetadataLogProcessor by @tinalenguyen in https://github.com/livekit/agents/pull/3697
* add Created-At header for the audio recording by @theomonnom in https://github.com/livekit/agents/pull/3698
* fix tool validation by @tinalenguyen in https://github.com/livekit/agents/pull/3699
* use otel logger for the chat_history by @theomonnom in https://github.com/livekit/agents/pull/3700
* Support Agent Session Tools  by @toubatbrian in https://github.com/livekit/agents/pull/3707
* add extra instructions + tools params into GetEmailTask by @tinalenguyen in https://github.com/livekit/agents/pull/3711
* format transcript logs by @paulwe in https://github.com/livekit/agents/pull/3708
* add participant attributes to traces by @theomonnom in https://github.com/livekit/agents/pull/3725
* fix duplicate `agent_session` span by @theomonnom in https://github.com/livekit/agents/pull/3726
* fix chat_history upload by @theomonnom in https://github.com/livekit/agents/pull/3728
* rename `realtime_session` to `rtc_session` by @theomonnom in https://github.com/livekit/agents/pull/3729
* add backward compatibility by @theomonnom in https://github.com/livekit/agents/pull/3730
* add missing options attr to session start log by @paulwe in https://github.com/livekit/agents/pull/3731
* brian/dtmf-send-tool by @toubatbrian in https://github.com/livekit/agents/pull/3656
* log potential thread leaks preventing process from exiting by @theomonnom in https://github.com/livekit/agents/pull/3744
* check room connection state + rename to on_emit + taskgroup fix by @tinalenguyen in https://github.com/livekit/agents/pull/3738
* add survey agent example by @tinalenguyen in https://github.com/livekit/agents/pull/3681
* update examples to use AgentServer by @tinalenguyen in https://github.com/livekit/agents/pull/3767
* allow multiple ids for out of scope by @tinalenguyen in https://github.com/livekit/agents/pull/3789
* add chat_history json to the report upload by @theomonnom in https://github.com/livekit/agents/pull/3799
* set log timestamps for chat history by @paulwe in https://github.com/livekit/agents/pull/3800
* check recorder_io in make_session_report by @tinalenguyen in https://github.com/livekit/agents/pull/3805
* feat(cartesia): add LiveKit user agent to requests by @mi-yu in https://github.com/livekit/agents/pull/3809
* Add Speechmatics TTS by @aaronng91 in https://github.com/livekit/agents/pull/3754
* built-in GetAddressTask by @tinalenguyen in https://github.com/livekit/agents/pull/3807
* fix extra instructions param and update confirm_address docstring by @tinalenguyen in https://github.com/livekit/agents/pull/3810
* Add support for using a previous silero vad model file by @zaheerabbas-prodigal in https://github.com/livekit/agents/pull/3779
* allow updating the same agent that is running to apply changes in agent by @longcw in https://github.com/livekit/agents/pull/3814
* chore: fix ruff & formatting by @davidzhao in https://github.com/livekit/agents/pull/3827
* fix type checking for agents 1.3 by @longcw in https://github.com/livekit/agents/pull/3842
* fix: correct base64 data handling in image content conversion #3867 by @tarsyang in https://github.com/livekit/agents/pull/3868
* fix observability by @davidzhao in https://github.com/livekit/agents/pull/3828
* avoid rotating transcription synchronizer twice during detach and attach by @longcw in https://github.com/livekit/agents/pull/3845
* fix pickling AgentServer for python 3.9 by @longcw in https://github.com/livekit/agents/pull/3847
* add better word alignment for Cartesia by @chenghao-mou in https://github.com/livekit/agents/pull/3876
* fix jupyter for agents 1.3 by @longcw in https://github.com/livekit/agents/pull/3877
* feat(minimax): comprehensive TTS updates and parameter rename by @zhenyujia23-crypto in https://github.com/livekit/agents/pull/3788
* feat(aws): add credentials customization for aws stt by @civilcoder55 in https://github.com/livekit/agents/pull/3840
* make sure user away timer is cancelled when session closed by @longcw in https://github.com/livekit/agents/pull/3895
* fix duplicate responses from gemini by @tinalenguyen in https://github.com/livekit/agents/pull/3898
* support google safety settings by @tinalenguyen in https://github.com/livekit/agents/pull/3815
* add audio_frame_size_ms for RoomInputOptions by @longcw in https://github.com/livekit/agents/pull/3899
* add new room options by @longcw in https://github.com/livekit/agents/pull/3417
* feat(tts): add sample rate option to TTS configuration for rime tts plugin arcana model  by @gokuljs in https://github.com/livekit/agents/pull/3910
* deepgram plugin: better websocket logs by @jjmaldonis in https://github.com/livekit/agents/pull/3912
* Add download location in readme by @chenghao-mou in https://github.com/livekit/agents/pull/3908
* chore: move LK env var checks later by @davidzhao in https://github.com/livekit/agents/pull/3920
* fix ForkServerContext import by @theomonnom in https://github.com/livekit/agents/pull/3924
* add timeout to datastream clear_buffer to avoid deadlock when missing playback finished event by @longcw in https://github.com/livekit/agents/pull/3917
* observability cleanup by @davidzhao in https://github.com/livekit/agents/pull/3929
* feature: GPT-5.1 support by @c0mpli in https://github.com/livekit/agents/pull/3928
* record when the session was started by @davidzhao in https://github.com/livekit/agents/pull/3930
* add <3.14 requirement temporarily by @chenghao-mou in https://github.com/livekit/agents/pull/3921
* Allow tool role for dummy user message by @chenghao-mou in https://github.com/livekit/agents/pull/3938
* add <3.14 requirement temporarily by @chenghao-mou in https://github.com/livekit/agents/pull/3942
* skip CI checks for md changes by @chenghao-mou in https://github.com/livekit/agents/pull/3939
* AGT-2200 Improve usage collector and metric logging with more details by @chenghao-mou in https://github.com/livekit/agents/pull/3935
* feat(cartesia): debug log Cartesia request id on WS connection by @mi-yu in https://github.com/livekit/agents/pull/3940
* Allow users to pick BVCTelephony at runtime by @bcherry in https://github.com/livekit/agents/pull/3926
* don't use decorators for setup_fnc & load_fnc by @theomonnom in https://github.com/livekit/agents/pull/3945
* expose `room_io` from the `AgentSession` by @theomonnom in https://github.com/livekit/agents/pull/3946
* Added Support for gpt-5.1-chat-latest by @devb-enp in https://github.com/livekit/agents/pull/3932
* turn-detection: use v0.4.1-intl by @lwestn in https://github.com/livekit/agents/pull/3941
* optimizations for turn detector model size by @davidzhao in https://github.com/livekit/agents/pull/3953
* feat: add AvatarTalk integration by @Maelstro in https://github.com/livekit/agents/pull/3139
* remove noisy error/warn logs by @theomonnom in https://github.com/livekit/agents/pull/3955
* release livekit-agents 1.3.1 by @theomonnom in https://github.com/livekit/agents/pull/3957

## New Contributors
* @mi-yu made their first contribution in https://github.com/livekit/agents/pull/3809
* @aaronng91 made their first contribution in https://github.com/livekit/agents/pull/3754
* @zaheerabbas-prodigal made their first contribution in https://github.com/livekit/agents/pull/3779
* @tarsyang made their first contribution in https://github.com/livekit/agents/pull/3868
* @chenghao-mou made their first contribution in https://github.com/livekit/agents/pull/3876
* @zhenyujia23-crypto made their first contribution in https://github.com/livekit/agents/pull/3788
* @civilcoder55 made their first contribution in https://github.com/livekit/agents/pull/3840
* @jjmaldonis made their first contribution in https://github.com/livekit/agents/pull/3912
* @c0mpli made their first contribution in https://github.com/livekit/agents/pull/3928
* @devb-enp made their first contribution in https://github.com/livekit/agents/pull/3932
* @Maelstro made their first contribution in https://github.com/livekit/agents/pull/3139

**Full Changelog**: https://github.com/livekit/agents/compare/livekit-agents@1.2.18...livekit-agents@1.3.1