Skip to main content

Simulator API

Pre-execution simulation for agent actions.

Functions​

simulateAction​

async function simulateAction(
  action: AgentAction,
  mode: 'local' | 'cloud' = 'local'
): Promise<SimulationResult>

Simulate action in LocalStack (Milestone 1) or ephemeral AWS stack (Milestone 2).

Types​

interface SimulationResult {
  fidelity: number;              // 0.0-1.0 accuracy score
  predicted_outcome: string;     // Human-readable prediction
  simulated_at: string;          // ISO 8601 timestamp
  duration_ms: number;           // Simulation latency
  tier: 'local' | 'cloud';
}

Source​

Implementation: packages/core/src/simulation/localstack.ts