| Symptom | Check |
|---|---|
HTTP 429 with no available capacity | No worker is available. Retry later; this is separate from request validation. |
| No prediction | Confirm a nonempty instruction, eight finite state values, and a newly delivered frame on every track after the request. |
| Resending produces no reply | Byte-identical state_json is deduplicated. A changed retry field requests fresh inference. |
| Checkpoint selection rejected | Inspect command_error and get_checkpoint. Choose from available before the first prediction; a different pinned choice requires a new session. |
| No new reply after reset | Reset retains the existing input value without answering it again. Send new state JSON and keep publishing frames. |
| Wrong reply reaches the controller | Match step to the outstanding request and consume each logical request once. |
| Robot motion looks incorrect | Confirm absolute joint targets in radians, correct joint order, and gripper 0 open / 1 closed. |
Timing is worse than inference_seconds | That field excludes transport and execution queues. Measure capture-to-execution latency separately. |
Troubleshooting
Diagnose missing predictions, checkpoint selection, and controller mismatches.
For support, provide the model slug, session ID, selected checkpoint, command/error names, state
shape, and timestamps. Do not include API keys. Contact Reactor.