Carolopedia

A public encyclopedia of Carolverse.

๐Ÿ“– Carolopedia โ€บ Droids โ€บ Carol Main Agent LoopEntity page

Carol Main Agent Loop

Droid

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