Interface: ScenarioHooks

Defined in: apps/paracosm/src/engine/types.ts:260

Lifecycle hooks that a scenario provides to inject domain-specific behavior into the generic engine. All hooks are optional.

Properties

departmentPromptHook()?

optional departmentPromptHook: (ctx) => string[]

Defined in: apps/paracosm/src/engine/types.ts:264

Builds department-specific prompt context lines for LLM department agents

Parameters

ctx

PromptHookContext

Returns

string[]

---

directorInstructions()?

optional directorInstructions: () => string

Defined in: apps/paracosm/src/engine/types.ts:266

Returns the Event Director's system instructions for this scenario

Returns

string

---

directorPromptHook()?

optional directorPromptHook: (ctx) => string

Defined in: apps/paracosm/src/engine/types.ts:268

Builds the Event Director's per-turn context prompt

Parameters

ctx

Record<string, unknown>

Returns

string

---

fingerprintHook()?

optional fingerprintHook: (finalState, outcomeLog, leader, toolRegs, maxTurns) => Record<string, string>

Defined in: apps/paracosm/src/engine/types.ts:272

Computes a timeline fingerprint classification from final simulation state

Parameters

finalState

SimulationState

outcomeLog

object[]

leader

LeaderConfig

toolRegs

Record<string, string[]>

maxTurns

number

Returns

Record<string, string>

---

getMilestoneEvent()?

optional getMilestoneEvent: (turn, maxTurns) => MilestoneEventDef | null

Defined in: apps/paracosm/src/engine/types.ts:274

Returns a milestone event for narrative anchor turns (turn 1, final turn)

Parameters

turn

number

maxTurns

number

Returns

MilestoneEventDef | null

---

politicsHook()?

optional politicsHook: (category, outcome) => Record<string, number> | null

Defined in: apps/paracosm/src/engine/types.ts:276

Returns politics deltas for political/social events, null if not applicable

Parameters

category

string

outcome

string

Returns

Record<string, number> | null

---

progressionHook()?

optional progressionHook: (ctx) => void

Defined in: apps/paracosm/src/engine/types.ts:262

Called during between-turn progression for scenario-specific health/field changes (e.g., radiation, bone density)

Parameters

ctx

ProgressionHookContext

Returns

void

---

reactionContextHook()?

optional reactionContextHook: (colonist, ctx) => string

Defined in: apps/paracosm/src/engine/types.ts:270

Returns location/identity/health phrasing for agent reaction prompts

Parameters

colonist

Agent

ctx

turn

number

year

number

Returns

string