Skip to main content
POST
Error

Authorizations

Authorization
string
header
required

Single per-partner bearer key, provisioned by Alakazam.

Path Parameters

id
string
required

Response

Fresh run booted; first observation of the new episode.

The SNN-controller observation contract. proximity = two virtual range sensors (0 = clear, 1.0 = contact range): compact obstacles grade by screen-space closeness, walls/elongated structures by time-to-contact; an object dead ahead excites both. collision is a TERMINAL SPIKE , true exactly once, on the step the contact engine confirms the hit , after which done stays true until reset.

proximity
object
collision
boolean

SPIKE, true exactly once per collision event (derived from the monotonic counter, so a pulse between two step reads is never missed). With terminal_collision=false the run continues and later events spike again.

collision_count
integer

Monotonic count of collision events this run.

done
boolean

Only latches when terminal_collision=true (or the world ends the run).

t_ms
integer

Milliseconds survived this run.

sensor_age_ms
integer | null

Lag accounting, how stale the sensor side (proximity/labels) is relative to the camera frame in the same observation. Cloud-detector worlds run ≈500–1000 ms behind; local-detector worlds tens of ms. Controllers should compensate or discount accordingly.

applied_action
string

The discrete action actually applied (echoes wheel quantization). Present on step responses.

labels
object[]
camera
object

Present when the session requested a camera resolution.