World

World is molroo's multi-persona simulation layer. It lets you create worlds — shared environments where multiple personas interact, form relationships, and generate emotion-driven events.

What is a World?

A world is a container for personas that share a common environment. Within a world you can:

• Add personas — link existing molroo persona configs into the world
• Execute actions — trigger interactions between actors and personas; the emotion engine processes each action and returns updated emotional state
• Track relationships — store trust and familiarity between actors and personas, which the engine uses as context when processing actions
• Query the event log — inspect a chronological record of all actions and their emotion outcomes

Emotion Engine

Worlds are powered by the same VAD (Valence–Arousal–Dominance) emotion engine as standalone molroo personas. Each action carries an appraisal vector that the engine uses to update a persona's emotional state in real time.

Getting Started

1. World API — REST endpoints for managing worlds and triggering actions
2. World SDK — Type-safe TypeScript client (@molroo-io/sdk/world)