gatos.get_vessel
tool Vessels and kittens
Read selected complete logical sections for one vessel.
- Use when
- Planning flight or inspecting fitted systems without walking the /sim field tree.
- Availability
- The requested telemetry detail streams must be enabled.
- Equivalent interface
gatos://vessels/{id}
Input
| Field | Type | Requirement | Description |
|---|---|---|---|
id | string | Required | Raw vessel id or the alias "active". |
include | string[] | null | Optional · null | Sections to return: flight, orbit, environment, propulsion, resources, power, control, modules, encounters, parts, paint, or all. |
Call example
gatos.get_vessel({"id":"active","include":["flight","orbit","propulsion","resources"]})Result
Identity and core state plus every requested section, with all matching nested modules or parts; snapshot_sequence and ut are included.
Errors
- ENOENT for a missing id or when active has no current vessel.
- EINVAL for an unknown include section.
Operational notes
- There is no result-size truncation. Request parts, paint, or all only when that nested state is actually useful.