Reorganize community environments - Move lean_proof_env, router_env, and philosophical_rlaif_env.py to environments/community/ - Add comprehensive README for community environments - This organizes community-contributed environments into a dedicated community folder for better maintainability and discoverability

environments/community/router_env/engine/agents/gmail_agent.py

@@ -0,0 +1,70 @@
+import logging
+import os
+from dotenv import load_dotenv
+from pathlib import Path
+from livekit.agents import Agent, AgentSession, JobContext, WorkerOptions, cli, mcp, ChatContext, function_tool, RunContext
+from livekit.plugins import deepgram, openai, silero
+from livekit.plugins.turn_detector.multilingual import MultilingualModel
+from typing import Optional, List
+
+
+load_dotenv(os.path.join(os.path.dirname(__file__), '..', '..', '.env'))
+
+
+logger = logging.getLogger("gmail-agent")
+
+class GmailAgent(Agent):
+    def __init__(self, 
+                 chat_ctx: ChatContext,
+                 tools: Optional[List[function_tool]] = None) -> None:
+        
+        final_instructions = (
+                "You are a Gmail specialist. You can manage emails by reading, searching, sending, and updating them (e.g., marking as read/unread, moving to folders). " +
+                "Use tools like 'read_emails', 'send_email', and 'update_email' to interact with Gmail. " +
+                "If sending an email, you might need a recipient; you know Gabin (gabin.fay@gmail.com). " +
+                "If your task is complete or the user asks for something outside your email management capabilities (e.g., math, calendar), " +
+                "you MUST use the 'delegate_to_router_agent' tool to return to the main assistant."
+            )
+        
+        all_tools = tools if tools is not None else []
+
+        mcp_servers_list = []
+        gumloop_mcp_url = os.getenv("GUMLOOP_GMAIL_MCP_URL")
+        if gumloop_mcp_url:
+            mcp_servers_list.append(
+                mcp.MCPServerHTTP(
+                    url=gumloop_mcp_url,
+                    timeout=5,
+                    client_session_timeout_seconds=5,
+                )
+            )
+        else:
+            logger.warning("GUMLOOP_GMAIL_MCP_URL not set. Gmail agent may not have all its tools.")
+
+        super().__init__(
+            instructions=final_instructions,
+            chat_ctx=chat_ctx,
+            allow_interruptions=True,
+            mcp_servers=mcp_servers_list,
+            tools=all_tools
+        )
+
+    async def on_enter(self):
+        self.session.generate_reply()
+
+async def entrypoint(ctx: JobContext):
+    await ctx.connect()
+
+    session = AgentSession(
+        vad=silero.VAD.load(),
+        stt=deepgram.STT(model="nova-3", language="multi"),
+        llm=openai.LLM(model="gpt-4o-mini"),
+        tts=openai.TTS(voice="alloy"),
+        turn_detection=MultilingualModel(),
+    )
+
+    await session.start(agent=GmailAgent(chat_ctx=session._chat_ctx), room=ctx.room)
+
+
+if __name__ == "__main__":
+    cli.run_app(WorkerOptions(entrypoint_fnc=entrypoint))