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/contact_agent.py

@@ -0,0 +1,69 @@
+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("contact-agent")
+
+class ContactAgent(Agent):
+    def __init__(self, 
+                 chat_ctx: ChatContext,
+                 tools: Optional[List[function_tool]] = None) -> None:
+        
+        final_instructions = (
+                "You are a Contact specialist. You can help find contact information such as phone numbers, email addresses, or other details for individuals. " +
+                "You can also add new contacts or update existing ones if tools like 'get_contact_details', 'add_contact', 'update_contact' are available. " +
+                "If your task is complete or the user asks for something outside your contact management capabilities (e.g., math, web search), " +
+                "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 = []
+        zapier_mcp_url = os.getenv("ZAPIER_CONTACT_MCP_URL")
+        if zapier_mcp_url:
+            mcp_servers_list.append(
+                mcp.MCPServerHTTP(
+                    url=zapier_mcp_url,
+                    timeout=5,
+                    client_session_timeout_seconds=5,
+                )
+            )
+        else:
+            logger.warning("ZAPIER_CONTACT_MCP_URL not set. Contact 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=ContactAgent(chat_ctx=session._chat_ctx), room=ctx.room)
+
+
+if __name__ == "__main__":
+    cli.run_app(WorkerOptions(entrypoint_fnc=entrypoint))