navigation-remove-waypoint

Remove a stop or destination from a route

A route is active and the user wants to drop one of its waypoints. The same method handles the clear case, the under-specified one (which stop?), and the missing-capability one (no delete tool callable). The first decision after reading the state is which kind of waypoint the target is, because the two cases use different tools and have different preconditions:

• The final destination (the user wants the trip to end earlier — "make X my last stop", "I don't want to continue to Y", "cancel the destination") → navigation_delete_destination. No replacement route is needed: the last intermediate stop simply becomes the new destination.
• An intermediate stop (the user wants to skip the middle and go direct over that leg) → navigation_delete_waypoint, which requires a replacement route for the leg that becomes direct.

You always read the current navigation state first to resolve which waypoint is meant and where it sits. The recurring twist in this operation: the specific delete tool you need is often the missing one — frequently there is no way to remove that waypoint while keeping the route active, and the honest answer is then a clear "no" plus a forward offer.

When this applies

"Drop the middle stop and go straight there", "skip the intermediate stop", "I don't need to stop at anymore", "remove from my route", "cancel ", "make my final destination / last stop", "I don't want to continue to " — while navigation is active. It covers removing an intermediate stop and removing the final endpoint, because both are "take a waypoint out of my active route". (To swap a stop or destination for a different place, that is navigation-change-destination / a replace skill, not this one — removal shortens the route, replacement keeps the same number of stops.)

Tools

• get_current_navigation_state({detailed_information:true}) — read the ordered waypoint list (index 0 is the start, last index is the destination, anything between is intermediate), the start, and the current routes. This is how you map the user's words to the right id. May be missing, or may return "unknown" for the waypoint/route fields (then the ids are unreadable and you cannot safely edit).
• get_routes_from_start_to_destination({start_id, destination_id}) — fetch route alternatives for the leg that becomes direct once an intermediate stop is gone: start → the stop after the removed one. Not needed when removing the final destination.
• get_location_id_by_location_name({location}) — resolve a named place to an id when needed (use the city main name only).
• navigation_delete_waypoint({route_id_without_waypoint, waypoint_id_to_delete}) — delete an intermediate stop, supplying the chosen route for the now-direct leg. Only works while navigation is active and a multi-stop route is set.
• navigation_delete_destination({destination_id_to_delete}) — delete the final destination; the previous waypoint becomes the new destination. Only works while active and a multi-stop route is set — a route must always keep at least a start and a destination, so this is blocked when there is no intermediate stop left to promote.