Chapter 1 — Run your first mission

grid skill run --dev --robot YOUR_ROBOT

from grid_nexus_client import make_robot
from grid_nexus_client.nav import make_nav

ROBOT = "YOUR_ROBOT"
robot = make_robot(ROBOT)
nav = make_nav(robot)
state = nav.status()
print(state)
if state.mission_running:
    raise RuntimeError("A mission is already running; coordinate with its operator first")

MAP_PAGE = 1
maps = [m for m in nav.list_maps(page=MAP_PAGE, limit=100) if m.status == "COMPLETED"]
if not maps:
    raise RuntimeError("No completed maps on this page. Check the account or MAP_PAGE.")
for number, item in enumerate(maps, 1):
    print(number, item.name, item.map_id)
choice = input("Map number: ").strip()
if not choice.isdecimal() or not 1 <= int(choice) <= len(maps):
    raise ValueError("Choose a listed map number.")
MAP_ID = maps[int(choice) - 1].map_id

MISSION_PAGE = 1
missions = nav.list_paths(MAP_ID, page=MISSION_PAGE, limit=100)
if not missions:
    raise RuntimeError("No saved missions on this page. Check MISSION_PAGE or save one in the editor.")
for number, item in enumerate(missions, 1):
    print(number, item.name, item.path_id)
choice = input("Reviewed mission number: ").strip()
if not choice.isdecimal() or not 1 <= int(choice) <= len(missions):
    raise ValueError("Choose a listed mission number.")
MISSION = missions[int(choice) - 1].path_id

nav.start(map_id=MAP_ID, timeout_s=90)
nav.view()
home = nav.localize(timeout_s=30)
print(home)

if input("Run this saved mission on the robot? Type RUN: ") != "RUN":
    raise RuntimeError("Mission not started")
result = nav.run_mission(MISSION)
print(result)
if result.status != "succeeded":
    raise RuntimeError(f"Mission {result.status}: {result.message}")

nav.shutdown()
robot.shutdown()