PARACOSM AGENTOS | API Reference v0.9.1035
Home Simulation API Docs GitHub npm
Home Simulation API Docs GitHub npm AgentOS Discord
paracosm - v0.9.1035
    Preparing search index...

    Interface ActorConfig

    Configuration for a simulation actor — the swappable decision-making entity that runs each parallel counterfactual. Was ActorConfig in 0.7.x; renamed in 0.8.0 to match the user-facing terminology (scenario.labels.actorNoun selects the per-domain label like "commander" / "mayor" / "release director").

    The legacy ActorConfig name is exported below as a @deprecated type alias so 0.7.x callers compile unchanged. Drop in 1.0.

    interface ActorConfig {
        archetype: string;
        hexaco?: HexacoProfile;
        instructions: string;
        name: string;
        traitProfile?: TraitProfile;
        unit: string;
    }
    Index
    archetype: string
    hexaco?: HexacoProfile

    Six-axis HEXACO personality profile. Optional in v0.9: callers supplying traitProfile (e.g. ai-agent leaders) can omit this. The runtime requires AT LEAST ONE of hexaco or traitProfile; normalizeActorConfig throws a clear error if both are missing. When both are supplied, traitProfile wins for cue translation + drift; hexaco is preserved on the artifact for legacy display.

    instructions: string
    name: string
    traitProfile?: TraitProfile

    Pluggable trait profile naming a registered TraitModel and its per-axis values. When set, this overrides the legacy hexaco field for cue translation, drift, and prompt generation. When omitted, the runtime synthesizes a profile from hexaco with modelId: 'hexaco'.

    unit: string

    The organizational unit / faction / org / team this leader commands (e.g. "Station Alpha", "Engineering Org", "Player Faction"). Was colony pre-0.5.0; renamed for domain-agnostic semantics so non-space scenarios (markets, game worlds, incident response) read naturally instead of being named after a Mars heritage concept.