voice-agent-expertlisted

# Voice Agent Expert – Debugging Cheat Sheet (Skill) This skill is a practical, "use-it-while-debugging" reference for getting a LiveKit + Letta voice agent working reliably. --- ## Core rules (fix 90% of issues) 1. **Override the right LiveKit hook** - The framework calls `llm_node`, **not** `generate_reply`. - If you override the wrong method, your changes won't run and your agent may "look alive" but never route text correctly. 2. **Only ONE voice-agent process can run at a time** - Duplicate processes commonly cause: - timeouts - audio cutting out - inconsistent behavior (you're looking at logs from one process while another is actually serving) 3. **Use `dev` mode for local testing** - `start` can sit waiting for dispatch and look "broken." - If you're actively testing locally, `dev` mode is the fast path. --- ## Nuclear reset (when it's just stuck) Run this when things are wedged, timeouts are happening, or audio is cutting out. It kills old processes, restarts LiveKit in dev mode, then restarts the Letta voice agent. ```bash pkill -9 -f letta_voice_agent.py pkill -f livekit-server sleep 2 cd /home/adamsl/ottomator-agents/livekit-agent nohup ./livekit-server --dev --bind 0.0.0.0 > /tmp/livekit.log 2>&1 & cd /home/adamsl/planner/a2a_communicating_agents/hybrid_letta_agents /home/adamsl/planner/.venv/bin/python3 letta_voice_agent.py dev > /tmp/letta_voice_agent.log 2>&1 & ``` --- ## Is it alive? checks (fastest signals) 1. **Li