gatos.command
tool Advanced commands
Submit any canonical action through the complete command envelope.
- Use when
- A logical family does not express the action clearly enough, or generic catalog-driven automation is desired.
- Availability
- The canonical action's own control/debug/feature gates.
Input
| Field | Type | Requirement | Description |
|---|---|---|---|
action | string | Required | Canonical action key from gatos.get_capabilities. |
vessel_id | string | Optional · "" | Raw vessel id. Global actions use an empty string. |
ordinal | integer | Optional · -1 | Module or entity ordinal where the action addresses one item. |
value | number | Optional · 0 | Primary scalar value. |
values | number[] | null | Optional · null | Vector, quaternion, color, or other ordered numeric payload. |
token | string | null | Optional · null | Named mode, id, field, or other action-specific token. |
aux | string | null | Optional · null | Secondary action-specific token. |
Call example
gatos.command({"action":"debug.teleport","vessel_id":"Hunter","ordinal":-1,"values":[6578100,0,0,0,7784,0]})Result
Validated command outcome including canonical action context and current freshness metadata.
Errors
- EINVAL for an unknown action or invalid shape; action-specific ENOENT/EACCES/EBUSY/EOPNOTSUPP/EIO.
Operational notes
- Call get_capabilities for units, addressing, phase, and safety metadata.
- Clients never choose Frame or Solver phase; the catalog derives it.