close_gallery
ChatGPTClose the gallery in the supplied atlas_instance_id and return to its atlas or journey. Safe to repeat. Requires a connected atlas_instance_id from the latest app context; never opens a new card. Wait for each action to finish before sending the next dependent action.
configure_atlas
ChatGPTConfigure the atlas date, relations, globe camera or bounds, names, borders and playback settings within the pinned release. Requires a connected atlas_instance_id from the latest app context; never opens a new card. Wait for each action to finish before sending the next dependent action.
configure_sky
ChatGPTSet live-sky culture, celestial labels, constellation lines/names/illustrations through the shared Cosmos controls. Preserves historical date and dataset revision. Live model context reports settings; atlas links do not encode them. Requires a connected atlas_instance_id from the latest app context; never opens a new card. Wait for each action to finish before sending the next dependent action.
connect_atlas
ChatGPTEstablish a transient command connection for the mounted atlas.
control_environment
ChatGPTControl the mounted, ready living environment: play, pause, seek to progress 0–1, or reset. Seek/reset pause; reduced motion prevents play. The fixed media date remains independent of atlas time. Requires a connected atlas_instance_id from the latest app context; never opens a new card. Wait for each action to finish before sending the next dependent action.
control_playback
ChatGPTPlay, pause, or resume the current journey, polity, or timeline. Play can restart completed playback; resume preserves progress. get_atlas_context reports its live phase. Requires a connected atlas_instance_id from the latest app context; never opens a new card. Wait for each action to finish before sending the next dependent action.
get_atlas_context
ChatGPTRead Terrava's current presentation, gallery context, underlying atlas state, music/sky preferences, and canonical route. Supply atlas_instance_id to read the mounted atlas; without a connected atlas, rendered inspection is unavailable.
inspect_polity
ChatGPTRead authored identity, published presence, interpretation, relationships, evidence, and citations for one published polity.
inspect_visible_scene
ChatGPTRead readiness and evidence for the visible atlas, live sky or gallery. An open artwork or living environment returns its presentation context, not obscured map features. No geometry or bulk release data. Supply atlas_instance_id to read the mounted atlas; without a connected atlas, rendered inspection is unavailable.
list_authored_journeys
ChatGPTList the published Terrava journey catalog and each journey's ordered moments.
list_polity_changes
ChatGPTList authored recorded changes for one polity within an optional date window.
open_authored_journey
ChatGPTStart a published journey. get_atlas_context reports its live playback phase. Requests to open, show, or put something in the side panel target the existing panel: "open Carthage in the side panel" and "show Orion in this panel" use update_atlas with the target atlas_instance_id from the latest app context and the requested destination command. This explicit target overrides new-result routing, including followup: new_result; do not create another inline card. Use update_atlas also for other explicit existing-map requests or for navigation in a direct-open workspace. New destination requests without an explicit existing target open independent map cards. Bare names such as "Athens", "Orion", "Carthage", and "now show Athens" use destination tools, even when a map is already open or expanded.
open_gallery
ChatGPTOpen available artwork or a living environment for the current polity. Show the polity first. Does not start passage playback. Links restore the item paused, without passage progress. Requests to open, show, or put something in the side panel target the existing panel: "open Carthage in the side panel" and "show Orion in this panel" use update_atlas with the target atlas_instance_id from the latest app context and the requested destination command. This explicit target overrides new-result routing, including followup: new_result; do not create another inline card. Use update_atlas also for other explicit existing-map requests or for navigation in a direct-open workspace. New destination requests without an explicit existing target open independent map cards. Bare names such as "Athens", "Orion", "Carthage", and "now show Athens" use destination tools, even when a map is already open or expanded.
open_terrava
ChatGPTOpen a new Terrava Home card by default; atlas_instance_id or canonical_url restores that view in a new card. show_polity opens a named polity. Requests to open, show, or put something in the side panel target the existing panel: "open Carthage in the side panel" and "show Orion in this panel" use update_atlas with the target atlas_instance_id from the latest app context and the requested destination command. This explicit target overrides new-result routing, including followup: new_result; do not create another inline card. Use update_atlas also for other explicit existing-map requests or for navigation in a direct-open workspace. New destination requests without an explicit existing target open independent map cards. Bare names such as "Athens", "Orion", "Carthage", and "now show Athens" use destination tools, even when a map is already open or expanded.
return_home
ChatGPTRun Terrava's Home action: stop playback, clear selection and reset date, camera and layers to Home in the latest available release. Requests to open, show, or put something in the side panel target the existing panel: "open Carthage in the side panel" and "show Orion in this panel" use update_atlas with the target atlas_instance_id from the latest app context and the requested destination command. This explicit target overrides new-result routing, including followup: new_result; do not create another inline card. Use update_atlas also for other explicit existing-map requests or for navigation in a direct-open workspace. New destination requests without an explicit existing target open independent map cards. Bare names such as "Athens", "Orion", "Carthage", and "now show Athens" use destination tools, even when a map is already open or expanded.
search_countries
ChatGPTFind present-day reference countries by name or code. Returns at most 20 country IDs and names, without historical claims or geometry.
search_sky
ChatGPTFind supported celestial objects, Polaris, Pleiades, galaxies, Orion Nebula, and constellations across sky cultures. Returns at most 20 stable IDs and names; live sky is independent of the historical atlas date.
search_terrava
ChatGPTSearch polities, dates, time ranges, political changes, and authored journeys in the selected immutable Terrava release.
show_authored_journey_moment
ChatGPTOpen a one-based published journey moment as an ordinary selected, shareable atlas scene. Requests to open, show, or put something in the side panel target the existing panel: "open Carthage in the side panel" and "show Orion in this panel" use update_atlas with the target atlas_instance_id from the latest app context and the requested destination command. This explicit target overrides new-result routing, including followup: new_result; do not create another inline card. Use update_atlas also for other explicit existing-map requests or for navigation in a direct-open workspace. New destination requests without an explicit existing target open independent map cards. Bare names such as "Athens", "Orion", "Carthage", and "now show Athens" use destination tools, even when a map is already open or expanded.
show_constellation
ChatGPTSelect a constellation by culture and constellation_id, enabling that culture. Historical date and release are unchanged. Requests to open, show, or put something in the side panel target the existing panel: "open Carthage in the side panel" and "show Orion in this panel" use update_atlas with the target atlas_instance_id from the latest app context and the requested destination command. This explicit target overrides new-result routing, including followup: new_result; do not create another inline card. Use update_atlas also for other explicit existing-map requests or for navigation in a direct-open workspace. New destination requests without an explicit existing target open independent map cards. Bare names such as "Athens", "Orion", "Carthage", and "now show Athens" use destination tools, even when a map is already open or expanded.
show_country
ChatGPTSelect and frame a present-day country using country_id from search_countries. Enables modern borders and country names, pauses playback, and preserves the historical date and range. To explore Greece or another country through history, select it first (via update_atlas for an explicit existing-map request), then configure_atlas with the historical range and control_playback on that same atlas_instance_id. Camera bounds alone do not select a country. Requests to open, show, or put something in the side panel target the existing panel: "open Carthage in the side panel" and "show Orion in this panel" use update_atlas with the target atlas_instance_id from the latest app context and the requested destination command. This explicit target overrides new-result routing, including followup: new_result; do not create another inline card. Use update_atlas also for other explicit existing-map requests or for navigation in a direct-open workspace. New destination requests without an explicit existing target open independent map cards. Bare names such as "Athens", "Orion", "Carthage", and "now show Athens" use destination tools, even when a map is already open or expanded.
show_polity
ChatGPTFind Athens or another historical polity by query (name or alias) or polity_id, exactly one. Without scene_version, navigation uses the latest frame. An undated request uses the polity's first map state; ambiguous names return choices. Requests to open, show, or put something in the side panel target the existing panel: "open Carthage in the side panel" and "show Orion in this panel" use update_atlas with the target atlas_instance_id from the latest app context and the requested destination command. This explicit target overrides new-result routing, including followup: new_result; do not create another inline card. Use update_atlas also for other explicit existing-map requests or for navigation in a direct-open workspace. New destination requests without an explicit existing target open independent map cards. Bare names such as "Athens", "Orion", "Carthage", and "now show Athens" use destination tools, even when a map is already open or expanded.
show_polity_change
ChatGPTOpen one exact authored polity change with its affected bounds, relation layer, before/after record, and evidence. Requests to open, show, or put something in the side panel target the existing panel: "open Carthage in the side panel" and "show Orion in this panel" use update_atlas with the target atlas_instance_id from the latest app context and the requested destination command. This explicit target overrides new-result routing, including followup: new_result; do not create another inline card. Use update_atlas also for other explicit existing-map requests or for navigation in a direct-open workspace. New destination requests without an explicit existing target open independent map cards. Bare names such as "Athens", "Orion", "Carthage", and "now show Athens" use destination tools, even when a map is already open or expanded.
show_sky_object
ChatGPTSelect a supported celestial object by object_id. Historical date and release are unchanged. Requests to open, show, or put something in the side panel target the existing panel: "open Carthage in the side panel" and "show Orion in this panel" use update_atlas with the target atlas_instance_id from the latest app context and the requested destination command. This explicit target overrides new-result routing, including followup: new_result; do not create another inline card. Use update_atlas also for other explicit existing-map requests or for navigation in a direct-open workspace. New destination requests without an explicit existing target open independent map cards. Bare names such as "Athens", "Orion", "Carthage", and "now show Athens" use destination tools, even when a map is already open or expanded.
update_atlas
ChatGPTRequests to open, show, or put something in the side panel target the existing panel: "open Carthage in the side panel" and "show Orion in this panel" use update_atlas with the target atlas_instance_id from the latest app context and the requested destination command. This explicit target overrides new-result routing, including followup: new_result; do not create another inline card. Use update_atlas also for other explicit existing-map requests or for navigation in a direct-open workspace. New destination requests without an explicit existing target open independent map cards. Bare names such as "Athens", "Orion", "Carthage", and "now show Athens" use destination tools, even when a map is already open or expanded. Requires atlas_instance_id and a command, for example {name: "show_polity", arguments: {query: "Carthage"}}. Returns no widget and waits for the target map's ready-frame report; disconnected targets return an error. Never create a replacement card when the target is unavailable.