Normalized BCP-47 language identifier. Accepts any common format. Examples:: LanguageCode("english") # → "en" LanguageCode("eng

Raised when an API request failed due to a connection error.

Raised when an API response has a status code of 4xx or 5xx.

Raised when an API request timed out.

Stateless container for a set of AI functions

A string with optional start and end timestamps for word-level alignment. Attributes: start_time: Word start time in seconds (NOT_GIVEN w

Instructions that adapt based on the user's input modality (audio vs. text). ``str(self)`` is what providers see when treating this as a plain st

Raised when an API request failed. This is used on our TTS/STT/LLM plugins.

Fake transport that structurally satisfies ``_StreamingTurnDetectionTransport``. Behavior is scriptable: ``run`` either sleeps until cancelled, r

Lifecycle manager for in-flight tool calls. Activity-scoped (``owning_activity`` set): tasks belong to one AgentActivity and are cancelled or

Exposes exactly two fixed tools: search_tools and call_tool. Unlike ToolSearchToolset which dynamically modifies the tool list, ToolProxyTool

Minimal AgentSession stand-in. Idle by default; tests emit state events via ``emit_agent_state`` / ``emit_user_state``.

AudioOutput implementation that streams audio to a remote avatar worker using LiveKit DataStream.

Wraps tools/toolsets and exposes a tool_search function for dynamic loading. Instead of loading all tool definitions into LLM context, this expos

Background task that fires filler speech during a long-running step.

Exception for BitHuman errors

Minimal wrapper that forwards capture_frame/flush/clear_buffer through next_in_chain. Used to exercise the auto-wrap and swap mechanics without

Map from input text to output content, tool calls, ttft, and duration

Inference Fallback Adapter: configuration for a fallback STT model that runs server-side in LiveKit Inference, providing automatic fallback between pr

Session-scoped toolset whose tools survive agent handoff. Background updates from tools in this toolset are delivered to whichever agent is c

A thread-safe buffer that behaves like an IO stream. Allows writing from one thread and reading from another.

AgentServer that captures config at run() time instead of blocking.

Exception raised when the duplex connection is closed.

Inference Fallback Adapter: configuration for a fallback TTS model that runs server-side in LiveKit Inference, providing automatic fallback between pr

Test agent that captures on_user_turn_exceeded events instead of responding.

Configuration for endpointing. All keys are optional. Missing keys inherit from the session default (at the ``Agent`` level) or use the docum

Definition for the audio to be played in the background Args: volume: The volume of the audio (0.0-1.0) probability: The pro

A search candidate derived from a single tool at index time.

Stable swap point at the bottom of an audio wrapper chain. Wrappers above hold a reference to the proxy; the actual sink lives in ``next_in_c

A class that can be used to decode audio stream into PCM AudioFrames. Decoders are stateful, and it should not be reused across multiple streams.