๐About
Publication is withheld. The supplied material does not include the runtime contract or a verified public projection from the owning app. Internal documentation alone does not establish publication approval.
๐Usage
This material cannot be published until the declared public fields are verified through shared.carolopedia_publication and the resulting content passes the publication gate with a valid provenance receipt.
๐Purpose
message-handler is the bridge between raw inbound messages and Carol's response. It decodes media attachments, manages typing indicators, runs the reflex quick-response path for instant acknowledgments, and orchestrates the full LLM-driven reply path for substantive responses. It also powers the web-chat endpoint for Google OAuth authenticated users.
๐Duties
- Receive and decode WhatsApp messages (text, voice, image, video, document)
- Transcribe voice messages via speech-to-text
- Send typing indicators for human-like pacing
- Run reflex quick-reply for instant acknowledgments before full processing
- Orchestrate the full LLM-driven reply path for substantive messages
- Handle web-chat messages from Google OAuth users via the internal relay
๐Constraints
- Must handle all WhatsApp message types (text, voice, image, video, document)
- Voice processing depends on Gemini/OpenAI TTS availability
- Reflex replies must complete in <3s for acceptable user experience
- Full processing can take up to 120s with tool calls
๐คBelongs to
Source: Droid Families ยท Public information reflected here.