πAbout
Carol Main Agent Loop supports Carolβs presence on WhatsApp. Its purpose is to keep Carol reachable and able to respond to messages.
πUsage
Readers encounter its work when messaging Carol on WhatsApp. It supports conversation by receiving incoming messages and coordinating their processing.
π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.