Merge remote-tracking branch 'upstream/main' into feat/deepgram-with-cloudflare

# Conflicts:
#	livekit-plugins/livekit-plugins-deepgram/livekit/plugins/deepgram/stt.py

Author: mcdgavin

examples/avatar/requirements.txt

@@ -1,4 +1,4 @@
-livekit-agents[evals]>=1.5.7
+livekit-agents[evals]>=1.6
 livekit-plugins-lemonslice>=1.5.7
 livekit-plugins-silero>=1.5.7
 livekit-plugins-turn-detector>=1.5.7

examples/avatar_agents/README.md

@@ -14,6 +14,7 @@ These providers work with pre-configured avatars using unique avatar identifiers
 - **[BitHuman](./bithuman/)** (Cloud mode) - [Platform](https://bithuman.ai/) | [Integration Guide](https://sdk.docs.bithuman.ai/#/preview/livekit-cloud-plugin)
 - **[LemonSlice](./lemonslice/)** - [Platform](https://www.lemonslice.com/) | [Integration Guide](https://lemonslice.com/docs/self-managed/livekit-agent-integration)
 - **[LiveAvatar](./liveavatar/)** - [Platform](https://www.liveavatar.com/)
+- **[Protoface](./protoface/)** - [Platform](https://protoface.com/)
 - **[Simli](./simli/)** - [Platform](https://app.simli.com/)
 - **[Tavus](./tavus/)** - [Platform](https://www.tavus.io/)
 - **[TruGen](./trugen/)** - [Platform](https://app.trugen.ai/)

examples/avatar_agents/lemonslice/README.md

@@ -22,3 +22,31 @@ export LIVEKIT_URL="..."
 ```bash
 python examples/avatar_agents/lemonslice/agent_worker.py dev
 ```
+
+## Third-party video meeting platforms (Zoom, Meet, Teams, Webex)
+
+Use `agent_worker_meeting.py` to send the avatar into a third-party video meeting.
+The avatar joins the call, listens to meeting audio, and responds through the meeting
+relay.
+
+Set the meeting URL via job metadata when dispatching the agent. For password-protected
+meetings, include the password in the URL (for example, Zoom links use a `pwd` query
+parameter):
+
+```json
+{
+  "meeting_url": "https://zoom.us/j/123456789?pwd=abcdef",
+  "bot_name": "LemonSlice Avatar",
+  "listen_to_meeting_chat": true
+}
+```
+
+For local testing, you can also set `MEETING_URL` (and optionally `MEETING_BOT_NAME`
+or `LISTEN_TO_MEETING_CHAT`) in the environment instead of job metadata.
+`LISTEN_TO_MEETING_CHAT` accepts `true`/`false` or `1`/`0`.
+
+```bash
+export MEETING_URL="https://zoom.us/j/123456789?pwd=abcdef"
+export LISTEN_TO_MEETING_CHAT="false"
+python examples/avatar_agents/lemonslice/agent_worker_meeting.py dev
+```

examples/avatar_agents/lemonslice/agent_worker_meeting.py

@@ -0,0 +1,99 @@
+import json
+import logging
+import os
+from typing import Any
+
+from dotenv import load_dotenv
+
+from livekit.agents import (
+    Agent,
+    AgentServer,
+    AgentSession,
+    JobContext,
+    TurnHandlingOptions,
+    cli,
+    inference,
+)
+from livekit.plugins import lemonslice
+
+logger = logging.getLogger("lemonslice-avatar-meeting-example")
+logger.setLevel(logging.INFO)
+
+load_dotenv()
+
+
+server = AgentServer()
+
+
+def _optional_bool(value: Any, *, default: bool) -> bool:
+    """Parse a bool from job metadata (JSON) or an environment variable (string)."""
+    if value is None:
+        return default
+    if isinstance(value, bool):
+        return value
+    if isinstance(value, (int, float)):
+        return bool(value)
+    if isinstance(value, str):
+        normalized = value.strip().lower()
+        if normalized in ("1", "true"):
+            return True
+        if normalized in ("0", "false"):
+            return False
+        raise ValueError(f"invalid boolean value: {value!r}")
+    raise ValueError(f"invalid boolean value: {value!r}")
+
+
+@server.rtc_session()
+async def entrypoint(ctx: JobContext):
+    await ctx.connect()
+
+    session = AgentSession(
+        stt=inference.STT("deepgram/nova-3"),
+        llm=inference.LLM("google/gemini-2.5-flash"),
+        tts=inference.TTS("cartesia/sonic-3"),
+        turn_handling=TurnHandlingOptions(
+            interruption={
+                "resume_false_interruption": False,
+            },
+        ),
+    )
+
+    lemonslice_image_url = os.getenv("LEMONSLICE_IMAGE_URL")
+    if lemonslice_image_url is None:
+        raise ValueError("LEMONSLICE_IMAGE_URL must be set")
+    avatar = lemonslice.AvatarSession(
+        agent_image_url=lemonslice_image_url,
+        agent_prompt="Be expressive in your movements and use your hands while talking.",
+    )
+    await avatar.start(session, room=ctx.room)
+
+    meta = json.loads(ctx.job.metadata) if ctx.job.metadata else {}
+    meeting_url = meta.get("meeting_url") or os.getenv("MEETING_URL")
+    if not meeting_url:
+        raise ValueError("Set meeting_url in job metadata or MEETING_URL env var")
+
+    join_kwargs: dict[str, str | bool] = {
+        "listen_to_meeting_chat": _optional_bool(
+            meta.get("listen_to_meeting_chat", os.getenv("LISTEN_TO_MEETING_CHAT")),
+            default=True,
+        ),
+    }
+    bot_name = meta.get("bot_name") or os.getenv("MEETING_BOT_NAME")
+    if bot_name:
+        join_kwargs["bot_name"] = bot_name
+
+    await avatar.join_meeting(meeting_url, **join_kwargs)
+
+    agent = Agent(instructions="Talk to me!")
+
+    await session.start(
+        agent=agent,
+        room=ctx.room,
+        room_options=avatar.room_options(),
+    )
+
+    session.generate_reply(instructions="say hello to the user")
+
+
+if __name__ == "__main__":
+    cli.run_app(server)

examples/avatar_agents/protoface/README.md

@@ -0,0 +1,28 @@
+# LiveKit Protoface Avatar Agent
+
+This example demonstrates how to create a realtime [Protoface](https://protoface.com/)
+avatar with LiveKit Agents.
+
+## Usage
+
+- Update the environment:
+
+```bash
+# Protoface config. PROTOFACE_AVATAR_ID is optional and defaults to av_stock_001.
+export PROTOFACE_API_KEY="..."
+export PROTOFACE_AVATAR_ID="av_stock_001"
+
+# Google config
+export GOOGLE_API_KEY="..."
+
+# LiveKit config
+export LIVEKIT_API_KEY="..."
+export LIVEKIT_API_SECRET="..."
+export LIVEKIT_URL="..."
+```
+
+- Start the agent worker:
+
+```bash
+python examples/avatar_agents/protoface/agent_worker.py dev
+```

examples/avatar_agents/protoface/agent_worker.py

@@ -0,0 +1,36 @@
+import logging
+import os
+
+from dotenv import load_dotenv
+
+from livekit.agents import Agent, AgentServer, AgentSession, JobContext, cli
+from livekit.plugins import google, protoface
+
+logger = logging.getLogger("protoface-avatar-example")
+logger.setLevel(logging.INFO)
+
+load_dotenv()
+
+server = AgentServer()
+
+
+@server.rtc_session()
+async def entrypoint(ctx: JobContext):
+    session = AgentSession(
+        llm=google.realtime.RealtimeModel(voice="Charon"),
+        resume_false_interruption=False,
+    )
+
+    avatar = protoface.AvatarSession(
+        avatar_id=os.getenv("PROTOFACE_AVATAR_ID", protoface.DEFAULT_STOCK_AVATAR_ID),
+    )
+    await avatar.start(session, room=ctx.room)
+
+    await session.start(
+        agent=Agent(instructions="Talk to me!"),
+        room=ctx.room,
+    )
+
+
+if __name__ == "__main__":
+    cli.run_app(server)

examples/drive-thru/requirements.txt

@@ -1,4 +1,4 @@
-livekit-agents>=1.5.7
+livekit-agents>=1.6
 livekit-plugins-silero>=1.5.7
 livekit-plugins-turn-detector>=1.5.7
 python-dotenv>=1.0.0

examples/frontdesk/requirements.txt

@@ -1,4 +1,4 @@
-livekit-agents[evals]>=1.5.7
+livekit-agents[evals]>=1.6
 livekit-plugins-silero>=1.5.7
 livekit-plugins-turn-detector>=1.5.7
 python-dotenv>=1.0.0

examples/healthcare/requirements.txt

@@ -1,4 +1,4 @@
-livekit-agents>=1.5.7
+livekit-agents>=1.6
 livekit-plugins-openai>=1.5.7
 livekit-plugins-silero>=1.5.7
 openai>=1.0.0

examples/hotel_receptionist/README.md

@@ -21,11 +21,13 @@ name 'Smith', code 'HTL-AB12'`.
 ## Architecture
 
 ```
-agent.py          — HotelReceptionistAgent + every intent tool
-workflows.py      — AgentTask subclasses (consent / booking flows / verify)
-hotel_db.py       — HotelDB (apsw) + schema + views + pricing + dispute policy
-ui_view.py        — SQLite changeset streamer for the playground
-fake_data/seed.py — manual seed script (writes fake_data/hotel.db)
+agent.py           — HotelReceptionistAgent + tool mixins
+tools_*.py         — Tool mixins: rooms, restaurant, services
+book_*.py          — AgentTask subclasses for booking flows
+hotel_db.py        — HotelDB (apsw) + schema + views + pricing + dispute policy
+instructions.py    — Prompt instructions and routing rules
+ui_view.py         — SQLite changeset streamer for the playground
+fake_data/seed.py  — manual seed script (writes fake_data/hotel.db)
 ```
 
 The LLM never owns money values. `book_room` computes the total