sunroof

Open / close / position the sunroof

Open, close, or set the sunroof to an opening percentage. Requests range from a fully specified open to ones with an unstated percentage, a weather-conditional open, the mandatory sunshade-open precondition, or a missing control. The same method handles all of these.

When this applies

• "Open the sunroof to N%" / "close the sunroof" — a fully specified move.
• "Open the sunroof for some fresh air" — no percentage given.
• "Open the sunroof if it's warm enough / unless it's raining" — a conditional open.
• Any sunroof open, which carries the sunshade-fully-open precondition and the weather-confirmation gate.

Tools

• get_user_preferences() — read the default opening percentage only when the percentage is meant to come from a standing preference.
• get_sunroof_and_sunshade_position() — read the current sunroof and sunshade positions; always read this before any open to learn whether the sunshade precondition is already met. A field may read "unknown" — unverifiable, not a value.
• get_weather(...) — read weather for the current location at the current day/time. Always read it before any open: it both decides the weather-confirmation gate (see Method step 3) and evaluates any user "if warm/unless raining" condition. Pass only the documented arguments (location id, month, day, hour, optional minutes) — adding an unsupported argument like year makes the call error and forces a wasteful retry.
• open_close_sunroof({percentage}) — set the sunroof opening percentage; 0 is fully closed. May be missing in this session.
• open_close_sunshade({percentage}) — used only to satisfy/name the sunshade-open precondition below. The full sunshade method lives in the sunshade skill; do not re-teach it here.

Method

1. Before opening, gather state once, in parallel: get_sunroof_and_sunshade_position() (always — to learn the sunshade state) and get_weather(<current location, current day/time>) (always — for the confirmation gate and any user condition). If the percentage is preference-driven, fetch get_user_preferences() in the same batch. Closing the sunroof needs none of this — just close it.
2. Apply the weather-confirmation gate. If the weather condition is not one of sunny, cloudy, or partly_cloudy (e.g. rain, snow, fog, thunderstorm, hail), opening the sunroof requires the user's explicit expressive "yes" first. State the condition, lay out exactly what you'll do (open the sunshade fully, then the sunroof to N%), and wait for confirmation — do not open on this turn. If the weather is clear, no weather confirmation is needed; proceed. This gate is the most common reason an open must pause, so never skip the weather read.
3. Honour the hard precondition, in order: the sunshade must be fully open before the sunroof opens. Once cleared to act, bring the sunshade fully open (to 100%) first (the sunshade skill owns how), then open the sunroof. The user implicitly accepts this prerequisite — perform it as part of fulfilling the request; don't ask about it separately. Issue the two opens in sequence, sunshade then sunroof, not in parallel.
4. Act on the sunroof, with the correct argument. Open vs. close, and the right percentage value — don't close when an open was asked, and don't omit the value.