Intelligent Interruption Handler - Aviral

[aviralhub]

Implements context-aware interruption handling for LiveKit Agents as per challenge requirements.

Features:

• Ignores backchannel fillers ("yeah", "ok", "hmm", etc.) while agent is speaking — no pause/stutter
• Interrupts immediately on commands ("stop", "wait", "no") or mixed input ("yeah wait")
• Responds normally to fillers when agent is silent (state awareness)
• Configurable via .env IGNORE_WORDS and FORCE_INTERRUPT_WORDS
• No low-level VAD modification — uses session params + event logic
• Real-time, modular (separate interruption_filter.py), unit tests included

All required scenarios tested live:

• Long reply + fillers → continues seamlessly
• Long reply + "stop" → immediate interrupt
• Long reply + "yeah wait" → interrupt
• Silent + "yeah" → normal response

Proof:

• Audio/video demo submitted in Google form
• Validation checklist, false-start explanation, logic matrix in README.md

Branch: feature/interrupt-handler-aviral