Actors
Profiles with roles, care context, temperament, relationships, movement, and memory.
Profile model
An actor is a durable profile, not a disposable request fixture. The profile carries identity, contact preferences, work and care context, affiliations, relationships, position, movement, temperament, and mutable state.
| Field | Meaning |
|---|---|
| Identity | Name, age, pronouns, email, phone, language, and occupation |
| Context | Affiliations, relationships, care, work, and public visibility |
| Behavior | Preferred channel, reply pace, clarity, trust, and health literacy |
| World state | Current location, movement leg, stress, relationship status, and pending decisions |
Roles and capabilities
Actors can participate in more than one part of the world. archetype is the primary identity; roles and capabilities describe what the actor can do.
| Role | Typical behavior |
|---|---|
patient | Requests care, books appointments, and receives messages |
caregiver | Acts on behalf of related profiles |
clinician | Responds to care and reviews clinical context |
practice-staff | Manages practice queues and operational work |
lab-worker | Processes samples and lab-related work |
public-figure | Adds sensitivity and public context |
external-agent | Represents another system or outside party |
Temperament and state
Temperament influences how an actor communicates and responds. Mutable state records what the world has done to them.
replyPaceandclarityshape message behavior.trustandhealthLiteracyare normalized from 0 to 1.stressrises while work waits or side effects fail.relationshipStatusmoves from active to at-risk to lost.waitingOnDecisionIdsprevents one actor from generating overlapping unresolved work.
Movement
Movement is a formal start → current → end leg. Each tick can progress that leg based on pace, mode, and upcoming appointments. Actors may be stationary or moving and can transition between home, wandering, errands, travel to the practice, and waiting.