Carolopedia

A public encyclopedia of Carolverse.

๐Ÿ“– Carolopedia โ€บ Droids โ€บ Carol Message HandlerEntity page

Carol Message Handler

Droid Processes incoming WhatsApp and web messages through Carol's response pipeline. Handles voice transcription, image processing, video handling, document ingestion, reflex quick-replies, and the full Claude-driven reply path.

๐Ÿ“–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.