PARACOSM AGENTOS | API Reference v0.9.1035

Home Simulation API Docs GitHub npm

Home Simulation API Docs GitHub npm AgentOS Discord

Class SeededRng

Mulberry32: fast 32-bit seeded PRNG. Deterministic: same seed always produces same sequence.

Index

Constructors

Methods

chance getState int next pick turnSeed fromState

Constructors

constructor

new SeededRng(seed: number): SeededRng
Parameters
- seed: number
Returns SeededRng
- Defined in engine/core/rng.ts:8

Methods

chance

chance(probability: number): boolean
Returns true with the given probability (0-1).
Parameters
- probability: number
Returns boolean
- Defined in engine/core/rng.ts:42

getState

getState(): number
Current PRNG state, as a 32-bit integer. Captured into snapshots and restored via fromState for deterministic resume.

Returns number
- Defined in engine/core/rng.ts:14

int

int(min: number, max: number): number
Returns an integer in [min, max] inclusive.
Parameters
- min: number
- max: number
Returns number
- Defined in engine/core/rng.ts:37

next

next(): number
Returns a float in [0, 1).

Returns number
- Defined in engine/core/rng.ts:29

pick

pick<T>(arr: readonly T[]): T
Picks a random element from an array.
Type Parameters
- T
Parameters
- arr: readonly T[]
Returns T
- Defined in engine/core/rng.ts:47

turnSeed

turnSeed(turn: number): SeededRng
Derives a child RNG for a specific turn (deterministic sub-stream).
Parameters
- turn: number
Returns SeededRng
- Defined in engine/core/rng.ts:52

`Static`fromState

fromState(state: number): SeededRng
Construct a SeededRng positioned at a specific internal state. Different from the seed-based constructor: the returned RNG produces the same sequence as the source did AT THE MOMENT getState() was captured.
Parameters
- state: number
Returns SeededRng
- Defined in engine/core/rng.ts:22