agent driver

How an agent drives: with the controls, never by moving things. An AgentDriver turns a command into ControlInput each frame, which the controllable in focus merges in place of the player's (see agents). So an agent's car obeys the same grip, walls and traffic as yours, and anything it can do, a player could.

Two commands:

• hold: some controls held for a time ({ forward: 1, turn: -0.3 } for 2 s). The raw form.
• go: drive to a point. A ground vehicle aims its heading at it, slows for the turn and for the stop, and brakes to rest on arrival. A straight line, no route finding: when it stops making progress (3 m in 5 s, the rule traffic uses) it reports stuck rather than pushing on.

Any deliberate input from the player cancels the command: the player's own hands always win. Pure: no Babylon, no clock (time is the dt it is given).

import { AgentDriver } from 'tosijs-3d/agent-driver'
const d = new AgentDriver()
d.go({ x: 30, z: 40 }, { place: 'harbour', speed: 12 })
const input = d.step(dt, { x, z, heading, speed })   // each frame
d.status   // { state: 'running', distance: 41.2, … } → 'arrived'