gatos.execute_batch
tool Advanced commands
Execute an ordered, atomic-admission, same-phase command group on one game tick.
- Use when
- Several state changes must reach the game together rather than across separate request/frame boundaries.
- Availability
- Every member's action gates apply.
Input
| Field | Type | Requirement | Description |
|---|---|---|---|
commands | command[] | Required | One through 64 canonical command envelopes; all actions must derive the same Frame or Solver phase. |
Call example
gatos.execute_batch({"commands":[{"action":"vessel.throttle","vessel_id":"Hunter","value":1},{"action":"vessel.ignite","vessel_id":"Hunter","value":1}]})Result
Accepted count, derived phase, overall result, and first failure index/action when execution fails.
Errors
- EINVAL for empty/over-64 batches, any invalid member, or mixed phases; action-specific failure after admission.
Operational notes
- The full array is validated before enqueue and submitted once.
- After a game-side failure, later commands still execute; the result reports the first failure.