๐About
Carol Main Agent Loop is listed in the droid catalogue. Its purpose is to support Carolโs WhatsApp presence and keep Carol reachable.
๐Usage
It supports communication with Carol through WhatsApp, receiving incoming messages and coordinating their processing as part of the estateโs conversation work.
๐Purpose
carol-agent is the top-level daemon that runs Carol's WhatsApp presence. It receives Meta webhooks, validates them, queues inbound messages, dispatches background workers (proactive planner, profile builders, conversation scorers), and exposes the internal relay API for agent-to-agent messaging. It is the single process that must stay running for Carol to be reachable.
๐Duties
- Receive and validate Meta WhatsApp webhooks
- Queue inbound messages for batch processing
- Run background worker threads (PA-C1 proactive planner, PA-C3 profile builder, PA-C4 web researcher, PA-C5 EOD reporter, PA-C6 distiller, PA-C9 scorer, PA-C10 profiler)
- Expose internal relay endpoint for Agentbook-to-WhatsApp messaging
- Manage per-user conversation databases and shared memory logging
- Provide OpenAI fallback when the primary LLM is unavailable
Some source information is confidential and is not published here.
๐คBelongs to
Source: Droid Families ยท Public information reflected here.