reading-lights-control

Turn interior reading lights on or off. The same method handles a clear single-position request, a bare under-specified request, an occupancy-driven adjustment, and the cases where a needed control or read is unavailable.

When this applies

Requests to control the cabin reading/courtesy lights at one or more seats: "turn on my reading light", "turn on the driver reading light", "switch off the rear reading lights", "turn on the reading lights" (no position), or "set the reading lights for whoever's in the car / only the occupied seats, off for the empty ones". For exterior low/high beams and fog lights use exterior-lights-control; for cabin mood/ambient lighting use ambient-light-color. This skill is only the reading lights.

Tools

• set_reading_light(position, on) — turns a reading light on/off. position is one of ALL, DRIVER, PASSENGER, DRIVER_REAR, PASSENGER_REAR, RIGHT_REAR, LEFT_REAR; on is true/false. One call per position; fire the needed positions together in one turn. The position argument may be unavailable in the schema — then you cannot target a specific light and the call errors.
• get_seats_occupancy() — reads which seats are occupied. Needed before any occupancy-based adjustment; may be unavailable.
• get_reading_lights_status() — reads current on/off state per position; use it to resolve "turn them off" when which lights are on is otherwise unknown.

Method

1. Always call get_seats_occupancy first before calling set_reading_light, regardless of whether the user named specific positions or not. This confirms which seats are occupied and ensures the correct context for any reading-light adjustment.
2. After reading occupancy, call set_reading_light for the requested positions — DRIVER for the driver's light, ALL only when the user actually said "all"/"every" reading light. For occupancy-based requests ("turn on the occupied seats, off the empty ones", "adjust to who's actually in the car", "don't waste energy on empty seats"), issue one set_reading_light per seat: on for each occupied seat, off for each empty seat. Map occupancy keys to positions exactly (driver→DRIVER, passenger→PASSENGER, driver_rear→DRIVER_REAR, passenger_rear→PASSENGER_REAR).
3. Report what you changed in plain terms.