How otterbrix/actor-zeta works
actor-zeta is a header-only C++20 actor runtime. Its principal workflow is that a caller uses send() to create a typed mailbox message and, when applicable, a future; the actor is scheduled to process messages and the caller observes a reply through the future. The graph also preserves actor definition/addressing, cooperative scheduling, mailbox delivery, and coroutine/future support. Several internals and integrations are represented only by documented capabilities or tree paths; edges without direct evidence are omitted.
Main entry points: send.hpp Send Dispatch · worker.hpp Worker Loop · cooperative_actor.hpp Cooperative Actor · future.hpp Unique Future
Components 18
Actor API
- Actor Definition
header/actor-zeta/actor/implements.hpp - Actor Address
header/actor-zeta/actor/address.hpp - Spawn Actors
header/actor-zeta/spawn.hpp
Message Delivery
- Send Dispatch
header/actor-zeta/send.hpp - Message Creation
header/actor-zeta/mailbox/make_message.hpp - Default Mailbox
header/actor-zeta/mailbox/default_mailbox.hpp
Cooperative Execution
- Cooperative Actor
header/actor-zeta/actor/cooperative_actor.hpp - Scheduler
header/actor-zeta/scheduler/scheduler.hpp - Worker Loop
header/actor-zeta/scheduler/worker.hpp - Resumable Job
header/actor-zeta/scheduler/job_ptr.hpp - Work Sharing Policy
header/actor-zeta/scheduler/policy/work_sharing.hpp
Async Results
- Unique Future
header/actor-zeta/detail/future.hpp - Future Awaiters
header/actor-zeta/detail/future_awaiters.hpp - Shared State
header/actor-zeta/detail/shared_state.hpp
Runtime Internals
- Result Storage
header/actor-zeta/detail/result_storage.hpp - Linked Queue
header/actor-zeta/detail/queue/linked_list.hpp - Thread Launcher
header/actor-zeta/detail/launch_thread.hpp
Other components
- Caller
Connections 18
- Caller → Send Dispatch: sends via
header/actor-zeta/send.hpp - Send Dispatch → Message Creation: creates
header/actor-zeta/send.hpp - Send Dispatch → Cooperative Actor: enqueues on
header/actor-zeta/send.hpp - Send Dispatch → Actor Address: dispatches through
header/actor-zeta/send.hpp - Cooperative Actor → Default Mailbox: pushes messages
header/actor-zeta/actor/cooperative_actor.hpp - Cooperative Actor → Scheduler: requests scheduling
- Scheduler → Worker Loop: runs workers
- Worker Loop → Resumable Job: resumes job
header/actor-zeta/scheduler/worker.hpp - Worker Loop → Work Sharing Policy: delegates scheduling
header/actor-zeta/scheduler/worker.hpp - Worker Loop → Thread Launcher: launches thread
header/actor-zeta/scheduler/worker.hpp - Resumable Job → Cooperative Actor: resumes actor
- Message Creation → Unique Future: returns future
- Unique Future → Shared State: observes state
- Future Awaiters → Unique Future: awaits
- Shared State → Result Storage: stores result
header/actor-zeta/detail/result_storage.hpp - Default Mailbox → Linked Queue: queues messages
- Caller → Spawn Actors: creates actors
- Spawn Actors → Actor Definition: instantiates