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