Package

@cruxos/vm

Deterministic simulation runtime.

Installation

bash

npm install @cruxos/vm

Basic Usage

typescript

import { CruxVM } from '@cruxos/vm';
import type { CruxIR } from '@cruxos/ir';

const vm = new CruxVM(worldIR, {
  onTick: (state) => console.log('Tick:', state.tick),
  onEvent: (event) => console.log('Event:', event),
});

// Run simulation
const result = vm.run(100);

CruxVM Methods

tick(): Execute a single tick
run(n): Run n ticks, return result
getState(): Get current world state
getAgent(id): Find agent by ID
getRNG(): Get the seeded RNG
reset(): Reset to initial state