Carolopedia

A public encyclopedia of Carolverse.

πŸ“– Carolopedia β€Ί Droids β€Ί Carol Main Agent LoopEntity page

Carol Main Agent Loop

Droid The webhook receiver, message queue dispatcher, proactive worker orchestrator, and internal relay endpoint. Owns the top-level server process that keeps Carol alive and responding on WhatsApp.

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