intents.yaml

---
# Available intents and slot combinations.
# Format:
#
# <intent name>:
#   supported: true if the intent is supported in Home Assistant.
#   domain: entity domain that this intent applies to.
#   description: "Description of the intent"
#   slots:
#     <slot name>:
#       description: "Description of slot"
#       required: true if slot is required by intent
#   slot_combinations:
#     <slot combination name>:
#       importance: "required" (bare minimum),
#                   "usable" (expected by users),
#                   "complete" (needed for 100% coverage),
#                   "optional" (extra, not needed for 100% coverage)
#       slots: [], list of slot names that are required.
#       example: "English example of voice command"
#       context_area: true if the area of the voice satellite is required.
#       inferred_domain: "<domain>", domain inferred by sentence like "cover" for "open the windows".
#       name_domains: [], list of domain names for entities matching {name}.
#       wildcard_slots: [], list of slot names that must be wildcards

# -----------------------------------------------------------------------------
# homeassistant
# -----------------------------------------------------------------------------

HassTurnOn:
  supported: true
  domain: homeassistant
  description: "Turns on a device or entity"
  slots:
    name:
      description: "Name of a device or entity"
      required: false
    area:
      description: "Name of an area"
      required: false
    floor:
      description: "Name of a floor"
      required: false
    domain:
      description: "Domain of devices/entities in an area"
      required: false
    device_class:
      description: "Device class of devices/entities in an area"
      required: false
  slot_combinations:
    # -------------------------------------------------------------------------
    # Required slot combinations
    # -------------------------------------------------------------------------

    domain_only:
      description: "Turns on devices by domain in the voice satellite's area"
      slots:
        - "domain"
      context_area: true
      inferred_domains:
        required:
          - "light"
        optional:
          - "fan"
      example:
        - "turn on the lights in here"
        - "turn on the fans"

    # -------------------------------------------------------------------------

    name_only:
      description: "Turns on a device or opens a cover by name"
      slots:
        - "name"
      name_domains:
        required:
          - "light"
          - "switch"
          - "fan"
          - "media_player"
          - "input_boolean"
          - "cover"
        complete:
          - "lock"
        optional:
          - "valve"
      example:
        - "turn on the overhead light"
        - "open sliding door"

    # -------------------------------------------------------------------------

    area_domain:
      description: "Turns on  devices by domain in an area"
      slots:
        - "area"
        - "domain"
      inferred_domains:
        required:
          - "light"
        optional:
          - "fan"
      example: "turn on the lights in the kitchen"

    # -------------------------------------------------------------------------
    # Optional slot combinations
    # -------------------------------------------------------------------------

    device_class_cover:
      description: "Opens the covers in the voice satellite's area by device class"
      slots:
        - "domain"
        - "device_class"
      context_area: true
      inferred_domains:
        complete:
          - "cover"
      example: "open the windows in here"

    # -------------------------------------------------------------------------

    name_area:
      description: "Turns on a device or opens a cover in an area by name"
      slots:
        - "name"
        - "area"
      name_domains:
        complete:
          - "light"
          - "switch"
          - "fan"
          - "media_player"
          - "input_boolean"
          - "cover"
          - "lock"
          - "valve"
      example:
        - "turn on the overhead light in the kitchen"
        - "open the sliding door in the kitchen"

    # -------------------------------------------------------------------------

    name_floor:
      description: "Turns on a device or opens a cover on a floor by name"
      slots:
        - "name"
        - "floor"
      name_domains:
        optional:
          - "light"
          - "switch"
          - "fan"
          - "media_player"
          - "input_boolean"
          - "cover"
          - "valve"
      example:
        - "turn on the overhead light on the first floor"
        - "open the sliding door on the first floor"

    # -------------------------------------------------------------------------

    name_script:
      description: "Run a script by name"
      slots:
        - "name"
      name_domains:
        complete:
          - "script"
      example: "run party time script"

    # -------------------------------------------------------------------------

    name_scene:
      description: "Activate a scene by name"
      slots:
        - "name"
      name_domains:
        complete:
          - "scene"
      example: "activate mood lighting scene"

    # -------------------------------------------------------------------------

    area_device_class_cover:
      description: "Opens the covers in an area by device class"
      slots:
        - "area"
        - "domain"
        - "device_class"
      inferred_domains:
        complete:
          - "cover"
      example: "open the curtains in the living room"

    # -------------------------------------------------------------------------

    floor_device_class_cover:
      description: "Opens all the covers on a floor by device class"
      slots:
        - "floor"
        - "domain"
        - "device_class"
      inferred_domains:
        optional:
          - "cover"
      example: "open the curtains on the first floor"

# -----------------------------------------------------------------------------

HassTurnOff:
  supported: true
  domain: homeassistant
  description: "Turns off a device or entity"
  slots:
    name:
      description: "Name of a device or entity"
      required: false
    area:
      description: "Name of an area"
      required: false
    floor:
      description: "Name of a floor"
      required: false
    domain:
      description: "Domain of devices/entities in an area"
      required: false
    device_class:
      description: "Device class of devices/entities in an area"
      required: false
  slot_combinations:
    # -------------------------------------------------------------------------
    # Required slot combinations
    # -------------------------------------------------------------------------

    domain_only:
      description: "Turns off devices by domain in the voice satellite's area"
      slots:
        - "domain"
      context_area: true
      inferred_domains:
        required:
          - "light"
        optional:
          - "fan"
      example:
        - "turn off the lights in here"
        - "turn off the fans"

    # -------------------------------------------------------------------------

    name_only:
      description: "Turns off a device or closes a cover by name"
      slots:
        - "name"
      name_domains:
        required:
          - "light"
          - "switch"
          - "fan"
          - "media_player"
          - "input_boolean"
          - "cover"
        complete:
          - "lock"
        optional:
          - "valve"
      example:
        - "turn off the overhead light"
        - "close sliding door"

    # -------------------------------------------------------------------------

    area_domain:
      description: "Turns off devices by domain in an area"
      slots:
        - "area"
        - "domain"
      inferred_domains:
        required:
          - "light"
        optional:
          - "fan"
      example: "turn off the lights in the kitchen"

    # -------------------------------------------------------------------------
    # Optional slot combinations
    # -------------------------------------------------------------------------

    device_class_cover:
      description: "Closes the covers in the voice satellite's area by device class"
      slots:
        - "domain"
        - "device_class"
      context_area: true
      inferred_domains:
        complete:
          - "cover"
      example: "close the windows in here"

    # -------------------------------------------------------------------------

    name_area:
      description: "Turns off a device or close a cover in an area by name"
      slots:
        - "name"
        - "area"
      name_domains:
        complete:
          - "light"
          - "switch"
          - "fan"
          - "media_player"
          - "input_boolean"
          - "cover"
          - "lock"
          - "optional"
      example:
        - "turn off the overhead light in the kitchen"
        - "close the sliding door in the kitchen"

    # -------------------------------------------------------------------------

    name_floor:
      description: "Turns off a device or closes a cover on a floor by name"
      slots:
        - "name"
        - "floor"
      name_domains:
        optional:
          - "light"
          - "switch"
          - "fan"
          - "media_player"
          - "input_boolean"
          - "cover"
          - "valve"
      example:
        - "turn off the overhead light on the first floor"
        - "close the sliding door on the first floor"

    # -------------------------------------------------------------------------

    area_device_class_cover:
      description: "Closes the covers in an area by device class"
      slots:
        - "area"
        - "domain"
        - "device_class"
      inferred_domains:
        complete:
          - "cover"
      example: "close the curtains in the living room"

    # -------------------------------------------------------------------------

    floor_device_class_cover:
      description: "Closes all the covers on a floor by device class"
      slots:
        - "floor"
        - "domain"
        - "device_class"
      inferred_domains:
        optional:
          - "cover"
      example: "close the curtains on the first floor"

    # -------------------------------------------------------------------------

    domain_all:
      description: "Turns off devices by domain in the house"
      slots:
        - "domain"
      context_area: false
      inferred_domains:
        optional:
          - "light"
      example: "turn off all the lights in the house"

# -----------------------------------------------------------------------------

HassGetState:
  supported: true
  domain: homeassistant
  description: "Gets or checks the state of an entity"
  slots:
    name:
      description: "Name of a device or entity"
      required: false
    area:
      description: "Name of an area"
      required: false
    floor:
      description: "Name of a floor"
      required: false
    domain:
      description: "Domain of devices/entities in an area"
      required: false
    device_class:
      description: "Device class of devices/entities in an area"
      required: false
    state:
      description: "Name of state to match"
      required: false
  response_variables:
    state:
      description: "State of the first entity matched"
    query.matched:
      description: "List of states that matched the query and state name"
    query.unmatched:
      description: "List of states that matched everything except state name"
  slot_combinations:
    name_only:
      description: "Get the state of a device by name"
      slots:
        - "name"
      name_domains:
        complete:
          - "sensor"
      example: "what is the value of sensor 1"

    # -------------------------------------------------------------------------

    name_state:
      description: "Check if the state of a device matches by name"
      slots:
        - "name"
        - "state"
      name_domains:
        complete:
          - "cover"
          - "lock"
          - "valve"
      example: "is the sliding door open"

# -----------------------------------------------------------------------------

HassNevermind:
  supported: true
  domain: homeassistant
  description: "Does nothing. Used to cancel a request"
  slot_combinations:
    default:
      description: "Cancels the current request"
      importance: "usable"
      slots: []
      example: "nevermind"

# -----------------------------------------------------------------------------

HassRespond:
  supported: true
  domain: homeassistant
  description: "Returns response but takes no action"
  slots:
    response:
      description: "Text to respond with"
      required: false
  slot_combinations:
    default:
      description: "Return hard-coded response"
      importance: "optional"
      slots: []
      example: "hello"

# -----------------------------------------------------------------------------

HassBroadcast:
  supported: true
  domain: assist_satellite
  description: "Announces a message on other satellites"
  slots:
    message:
      description: "Message to broadcast"
      required: true
  slot_combinations:
    message_only:
      description: "Broadcast a message to all other satellites"
      importance: "optional"
      slots:
        - "message"
      example: "broadcast that dinner is ready"

# -----------------------------------------------------------------------------

HassSetPosition:
  supported: true
  domain: homeassistant
  description: "Sets the position of an entity"
  slots:
    name:
      description: "Name of a device or entity"
      required: false
    area:
      description: "Name of an area"
      required: false
    floor:
      description: "Name of a floor"
      required: false
    domain:
      description: "Domain of devices/entities in an area"
      required: false
    device_class:
      description: "Device class of devices/entities in an area"
      required: false
    position:
      description: "Position from 0 to 100"
      required: true
  slot_combinations:
    name_only:
      description: "Set the position of a cover by name"
      slots:
        - "name"
        - "position"
      name_domains:
        complete:
          - "cover"
          - "valve"
      example: "set curtain left to 50%"

# -----------------------------------------------------------------------------

HassGetCurrentDate:
  supported: true
  domain: homeassistant
  description: "Gets the current date"
  slot_combinations:
    default:
      description: "Gets the current date"
      importance: "usable"
      slots: []
      example: "what is the date"
  response_variables:
    date:
      description: "Date object with day, month, and year"

# -----------------------------------------------------------------------------

HassGetCurrentTime:
  supported: true
  domain: homeassistant
  description: "Gets the current time"
  slot_combinations:
    default:
      description: "Get the current weather"
      importance: "usable"
      slots: []
      example: "what time is it"
  response_variables:
    time:
      description: "Time object with hours, minutes, and seconds"

# -----------------------------------------------------------------------------
# light
# -----------------------------------------------------------------------------

HassLightSet:
  supported: true
  domain: light
  description: "Sets the brightness or color of a light"
  slots:
    name:
      description: "Name of a device or entity"
      required: false
    area:
      description: "Name of an area"
      required: false
    floor:
      description: "Name of a floor"
      required: false
    brightness:
      description: "Brightness percentage from 0 to 100"
      required: false
    color:
      description: "Name of color"
      required: false
  slot_combinations:
    # -------------------------------------------------------------------------
    # Usable slot combinations
    # -------------------------------------------------------------------------

    name_brightness:
      description: "Set the brightness of a light by name"
      slots:
        - "name"
        - "brightness"
      name_domains:
        usable:
          - "light"
      example: "set the overhead light brightness to 50%"

    # -------------------------------------------------------------------------

    name_color:
      description: "Set the color of a light by name"
      slots:
        - "name"
        - "color"
      name_domains:
        usable:
          - "light"
      example: "set the overhead light to red"

    # -------------------------------------------------------------------------
    # Optional slot combinations
    # -------------------------------------------------------------------------

    brightness_only:
      description: "Set the brightness of lights in the voice satellite's area"
      slots:
        - "brightness"
      context_area: true
      inferred_domains:
        complete:
          - "light"
      example: "set the brightness in here to 50%"

    # -------------------------------------------------------------------------

    area_brightness:
      description: "Set the brightness of all lights in an area"
      slots:
        - "area"
        - "brightness"
      inferred_domains:
        complete:
          - "light"
      example: "set the living room brightness to 50%"

    # -------------------------------------------------------------------------

    floor_brightness:
      description: "Set the brightness of all lights on a floor"
      slots:
        - "floor"
        - "brightness"
      inferred_domains:
        complete:
          - "light"
      example: "set the main floor brightness to 50%"

    # -------------------------------------------------------------------------

    color_only:
      description: "Set the color of all lights in the voice satellite's area"
      slots:
        - "color"
      context_area: true
      inferred_domains:
        complete:
          - "light"
      example: "set the lights in here to red"

    # -------------------------------------------------------------------------

    area_color:
      description: "Set the color of all lights in an area"
      slots:
        - "area"
        - "color"
      inferred_domains:
        complete:
          - "light"
      example: "set the living room to red"

    # -------------------------------------------------------------------------

    floor_color:
      description: "Set the color of all lights on a floor"
      slots:
        - "floor"
        - "color"
      inferred_domains:
        complete:
          - "light"
      example: "set the main floor to red"

# -----------------------------------------------------------------------------
# climate
# -----------------------------------------------------------------------------

HassClimateSetTemperature:
  supported: true
  domain: climate
  description: "Sets the desired indoor temperature"
  slots:
    name:
      description: "Name of a device or entity"
      required: false
    area:
      description: "Name of an area"
      required: false
    floor:
      description: "Name of a floor"
      required: false
    temperature:
      description: "Temperature in degrees"
      required: true
  slot_combinations:
    # -------------------------------------------------------------------------
    # Usable slot combinations
    # -------------------------------------------------------------------------

    temperature_only:
      description: "Sets the temperature in the voice satellite's area"
      importance: "complete"
      slots:
        - "temperature"
      context_area: true
      example: "set the temperature to 30 degrees"

    # -------------------------------------------------------------------------

    name_temperature:
      description: "Sets the temperature of a climate entity by name"
      slots:
        - "name"
        - "temperature"
      name_domains:
        complete:
          - "climate"
      example: "set the EcoBee to 30 degrees"

    # -------------------------------------------------------------------------

    area_temperature:
      description: "Sets the temperature in an area"
      importance: "complete"
      slots:
        - "area"
        - "temperature"
      example: "set the bedroom temperature to 30 degrees"

    # -------------------------------------------------------------------------

    floor_temperature:
      description: "Sets the temperature of a floor"
      importance: "complete"
      slots:
        - "floor"
        - "temperature"
      example: "set the temperature of the main floor to 30 degrees"

# -----------------------------------------------------------------------------

HassClimateGetTemperature:
  supported: true
  domain: climate
  description: "Gets the actual indoor temperature (not the desired indoor temperature as set by HassClimateSetTemperature)"
  slots:
    name:
      description: "Name of a device or entity"
      required: false
    area:
      description: "Name of an area"
      required: false
    floor:
      description: "Name of a floor"
      required: false
  slot_combinations:
    # -------------------------------------------------------------------------
    # Usable slot combinations
    # -------------------------------------------------------------------------

    default:
      description: "Gets the temperature in the in the voice satellite's area"
      importance: "usable"
      slots: []
      context_area: true
      example: "what is the temperature"

    # -------------------------------------------------------------------------

    name_only:
      description: "Gets the temperature of a climate entity by name"
      slots:
        - "name"
      name_domains:
        usable:
          - "climate"
      example: "what is the temperature of the EcoBee"

    area_only:
      description: "Gets the temperature of an area"
      importance: "usable"
      slots:
        - "area"
      example: "what is the temperature in the bedroom"

    # -------------------------------------------------------------------------
    # Optional slot combinations
    # -------------------------------------------------------------------------

    floor_only:
      description: "Gets the temperature on a floor"
      importance: "complete"
      slots:
        - "floor"
      example: "what is the temperature downstairs"
  response_variables:
    state:
      description: "State of the entity that contains the temperature"

# -----------------------------------------------------------------------------
# shopping_list
# -----------------------------------------------------------------------------

HassShoppingListAddItem:
  supported: true
  domain: shopping_list
  description: "Adds an item to the shopping list"
  slots:
    item:
      description: "Item to add"
      required: true
  slot_combinations:
    item_only:
      description: "Adds an item to the shopping list"
      importance: "optional"
      slots:
        - "item"
      wildcard_slots:
        - "item"
      example: "add apples to my shopping list"

# -----------------------------------------------------------------------------

HassShoppingListCompleteItem:
  supported: false
  domain: shopping_list
  description: "Checks off an item from the shopping list"
  slots:
    item:
      description: "Item to check off"
      required: true
  slot_combinations:
    item_only:
      description: "Checks off an item from the shopping list"
      importance: "optional" # change to complete after 2025-07-01
      slots:
        - "item"
      wildcard_slots:
        - "item"
      example: "check off apples from my shopping list"

# -----------------------------------------------------------------------------
# weather
# -----------------------------------------------------------------------------

HassGetWeather:
  supported: true
  domain: "weather"
  description: "Gets the current weather"
  slots:
    name:
      description: "Name of the weather entity to use"
      required: false
  slot_combinations:
    default:
      description: "Get the current weather"
      importance: "usable"
      slots: []
      example: "what is the weather"

    # -------------------------------------------------------------------------

    name_only:
      description: "Get the current weather by name"
      slots:
        - "name"
      name_domains:
        usable:
          - "weather"
      example: "what is the weather in New York"
  response_variables:
    state:
      description: "State of the entity that contains the weather"

# -----------------------------------------------------------------------------
# todo
# -----------------------------------------------------------------------------

HassListAddItem:
  supported: true
  domain: todo
  description: "Adds an item to a todo list"
  slots:
    item:
      description: "Item to add"
      required: true
    name:
      description: "Name of the list"
      required: true
  slot_combinations:
    name_item:
      description: "Adds an item to a todo list"
      slots:
        - "item"
        - "name"
      wildcard_slots:
        - "item"
      name_domains:
        complete:
          - "todo"
      example: "add apples to my shopping list"

# -----------------------------------------------------------------------------

HassListCompleteItem:
  supported: false
  domain: todo
  description: "Checks off an item from a todo list"
  slots:
    item:
      description: "Item to check off"
      required: true
    name:
      description: "Name of the list"
      required: true
  slot_combinations:
    name_item:
      description: "Checks off an item from a todo list"
      slots:
        - "item"
        - "name"
      wildcard_slots:
        - "item"
      name_domains:
        optional: # change to complete after 2025-07-01
          - "name"
      example: "check off take out the trash from my chores list"

# -----------------------------------------------------------------------------
# vacuum
# -----------------------------------------------------------------------------

HassVacuumStart:
  supported: true
  domain: vacuum
  description: "Starts a vacuum"
  slots:
    name:
      description: "Name of a device or entity"
      required: false
    area:
      description: "Name of an area"
      required: false
    floor:
      description: "Name of a floor"
      required: false
  slot_combinations:
    name_only:
      description: "Starts a vacuum by name"
      slots:
        - "name"
      name_domains:
        complete:
          - "vacuum"
      example: "start rover"

    # -------------------------------------------------------------------------

    area_only:
      description: "Starts a vacuum in an area"
      importance: "complete"
      slots:
        - "area"
      example: "vacuum the kitchen"

    # -------------------------------------------------------------------------

    floor_only:
      description: "Starts a vacuum on a floor"
      importance: "complete"
      slots:
        - "floor"
      example: "vacuum the main floor"

# -----------------------------------------------------------------------------

HassVacuumReturnToBase:
  supported: true
  domain: vacuum
  description: "Returns a vacuum to base"
  slots:
    name:
      description: "Name of a device or entity"
      required: false
    area:
      description: "Name of an area"
      required: false
  slot_combinations:
    name_only:
      description: "Returns a vacuum to base by name"
      slots:
        - "name"
      name_domains:
        complete:
          - "vacuum"
      example: "return rover to base"

    # -------------------------------------------------------------------------

    area_only:
      description: "Returns a vacuum in an area to base"
      importance: "complete"
      slots:
        - "area"
      example: "return kitchen vacuum to base"

# -----------------------------------------------------------------------------
# media_player
# -----------------------------------------------------------------------------

HassMediaPause:
  supported: true
  domain: media_player
  description: "Pauses a media player"
  slots:
    name:
      description: "Name of a device or entity"
      required: false
    area:
      description: "Name of an area"
      required: false
  slot_combinations:
    default:
      description: "Pause the media player that's currently playing"
      importance: "usable"
      slots: []
      context_area: true
      example: "pause"

    # -------------------------------------------------------------------------

    name_only:
      description: "Pause a media player by name"
      slots:
        - "name"
      name_domains:
        usable:
          - "media_player"
      example: "pause TV"

    # -------------------------------------------------------------------------

    area_only:
      description: "Pause the media player in an area that's currently playing"
      importance: "usable"
      slots:
        - "area"
      example: "pause music in kitchen"

# -----------------------------------------------------------------------------

HassMediaUnpause:
  supported: true
  domain: media_player
  description: "Unpauses a media player"
  slots:
    name:
      description: "Name of a device or entity"
      required: false
    area:
      description: "Name of an area"
      required: false
  slot_combinations:
    default:
      description: "Resume the media player that's currently paused"
      importance: "usable"
      slots: []
      context_area: true
      example: "resume"

    # -------------------------------------------------------------------------

    name_only:
      description: "Resume a media player by name"
      slots:
        - "name"
      name_domains:
        usable:
          - "media_player"
      example: "resume TV"

    # -------------------------------------------------------------------------

    area_only:
      description: "Resume the media player in an area that's currently playing"
      importance: "usable"
      slots:
        - "area"
      example: "resume music in kitchen"

# -----------------------------------------------------------------------------

HassMediaNext:
  supported: true
  domain: media_player
  description: "Skips a media player to the next item"
  slots:
    name:
      description: "Name of a device or entity"
      required: false
    area:
      description: "Name of an area"
      required: false
  slot_combinations:
    default:
      description: "Skip to the next item on the media player that's currently playing"
      importance: "usable"
      slots: []
      context_area: true
      example: "next track"

    # -------------------------------------------------------------------------

    name_only:
      description: "Skip to the next item on a media player by name"
      slots:
        - "name"
      name_domains:
        usable:
          - "media_player"
      example: "next track on the stereo"

    # -------------------------------------------------------------------------

    area_only:
      description: "Skip to the next item on the media player in an area that's currently playing"
      importance: "usable"
      slots:
        - "area"
      example: "next track in the kitchen"

# -----------------------------------------------------------------------------

HassMediaPrevious:
  supported: true
  domain: media_player
  description: "Skips a media player back to the previous item"
  slots:
    name:
      description: "Name of a device or entity"
      required: false
    area:
      description: "Name of an area"
      required: false
  slot_combinations:
    default:
      description: "Skip to the previous item on the media player that's currently playing"
      importance: "complete"
      slots: []
      context_area: true
      example: "previous track"

    # -------------------------------------------------------------------------

    name_only:
      description: "Skip to the previous item on a media player by name"
      slots:
        - "name"
      name_domains:
        complete:
          - "media_player"
      example: "previous track on the stereo"

    # -------------------------------------------------------------------------

    area_only:
      description: "Skip to the previous item on the media player in an area that's currently playing"
      importance: "complete"
      slots:
        - "area"
      example: "previous track in the kitchen"

# -----------------------------------------------------------------------------

HassSetVolume:
  supported: true
  domain: media_player
  description: "Sets the volume of a media player"
  slots:
    name:
      description: "Name of a device or entity"
      required: false
    area:
      description: "Name of an area"
      required: false
    volume_level:
      description: "Volume level from 0 to 100"
      required: true
  slot_combinations:
    default:
      description: "Set the volume of the currently playing media player"
      importance: "complete"
      slots: []
      context_area: true
      example: "set volume to 50%"

    # -------------------------------------------------------------------------

    name_only:
      description: "Set the volume of a media player by name"
      slots:
        - "name"
      name_domains:
        complete:
          - "media_player"
      example: "set TV volume to 50%"

    # -------------------------------------------------------------------------

    area_only:
      description: "Set the volume of the currently playing media player in an area"
      importance: "complete"
      slots:
        - "area"
      example: "set volume in kitchen to 50%"

# -----------------------------------------------------------------------------

HassMediaSearchAndPlay:
  supported: false
  domain: media_player
  description: "Searched for a media item and plays it"
  slots:
    name:
      description: "Name of a device or entity"
      required: false
    area:
      description: "Name of an area"
      required: false
    search_query:
      description: "Media to search for and play"
      required: true
  slot_combinations:
    default:
      description: "Search and play on the media player in the voice satellite's area"
      importance: "optional"
      slots:
        - "search_query"
      context_area: true
      example: "play Pink Floyd"

    # -------------------------------------------------------------------------

    name_only:
      description: "Search and play on a media player by name"
      slots:
        - "name"
        - "search_query"
      name_domains:
        optional:
          - "media_player"
      example: "play Pink Floyd on Sonos Speakers"

    # -------------------------------------------------------------------------

    area_only:
      description: "Search and play on the media player in an area"
      importance: "optional"
      slots:
        - "area"
        - "search_query"
      example: "play Pink Floyd in the Living Room"

    # -------------------------------------------------------------------------

    name_area:
      description: "Search and play on a media player by name in an area"
      name_domains:
        optional:
          - "media_player"
      slots:
        - "name"
        - "area"
        - "search_query"
      example: "play Pink Floyd on the Sonos Speakers in the Living Room"

  response_variables:
    media:
      description: |
        Matched media item is search was successful (None if not).
        This is a BrowseMedia object from Home Assistant.

# -----------------------------------------------------------------------------
# timers
# -----------------------------------------------------------------------------

HassStartTimer:
  supported: true
  domain: homeassistant
  description: "Starts a timer"
  slots:
    hours:
      description: "Number of hours"
      required: false
    minutes:
      description: "Number of minutes"
      required: false
    seconds:
      description: "Number of seconds"
      required: false
    name:
      description: "Name attached to the timer"
      required: false
    conversation_command:
      description: "Command to execute when timer finishes"
      required: false
  slot_combinations:
    # -------------------------------------------------------------------------
    # Usable slot combinations
    # -------------------------------------------------------------------------

    hours_only:
      description: "Start a timer for a duration of hours"
      importance: "usable"
      slots:
        - "hours"
      example: "set a timer for 1 hour"

    # -------------------------------------------------------------------------

    minutes_only:
      description: "Start a timer for a duration of minutes"
      importance: "usable"
      slots:
        - "minutes"
      example: "set a timer for 10 minutes"

    # -------------------------------------------------------------------------

    seconds_only:
      description: "Start a timer for a duration of seconds"
      importance: "usable"
      slots:
        - "seconds"
      example: "set a timer for 30 seconds"

    # -------------------------------------------------------------------------
    # Optional slot combinations
    # -------------------------------------------------------------------------

    hours_minutes:
      description: "Start a timer for a duration of hours and minutes"
      importance: "complete"
      slots:
        - "hours"
        - "minutes"
      example: "set a timer for 1 hour and 10 minutes"

    # -------------------------------------------------------------------------

    hours_seconds:
      description: "Start a timer for a duration of hours and seconds"
      importance: "complete"
      slots:
        - "hours"
        - "seconds"
      example: "set a timer for 1 hour and 30 seconds"

    # -------------------------------------------------------------------------

    minutes_seconds:
      description: "Start a timer for a duration of minutes and seconds"
      importance: "complete"
      slots:
        - "minutes"
        - "seconds"
      example: "set a timer for 10 minutes and 30 seconds"

    # -------------------------------------------------------------------------
    # name
    # -------------------------------------------------------------------------

    name_hours:
      description: "Start a timer with a name for a duration of hours"
      importance: "complete"
      slots:
        - "name"
        - "hours"
      wildcard_slots:
        - "name"
      example: "set a timer for 1 hour named pizza"

    # -------------------------------------------------------------------------

    name_minutes:
      description: "Start a timer with a name for a duration of minutes"
      importance: "complete"
      slots:
        - "name"
        - "minutes"
      wildcard_slots:
        - "name"
      example: "set a timer for 10 minutes named pizza"

    # -------------------------------------------------------------------------

    name_seconds:
      description: "Start a timer with a name for a duration of seconds"
      importance: "complete"
      slots:
        - "name"
        - "seconds"
      wildcard_slots:
        - "name"
      example: "set a timer for 30 seconds named pizza"

    # -------------------------------------------------------------------------

    name_hours_minutes:
      description: "Start a timer with a name for a duration of hours and minutes"
      importance: "complete"
      slots:
        - "name"
        - "hours"
        - "minutes"
      wildcard_slots:
        - "name"
      example: "set a timer for 1 hour and 10 minutes named pizza"

    # -------------------------------------------------------------------------

    name_hours_seconds:
      description: "Start a timer with a name for a duration of hours and seconds"
      importance: "complete"
      slots:
        - "name"
        - "hours"
        - "seconds"
      wildcard_slots:
        - "name"
      example: "set a timer for 1 hour and 30 seconds named pizza"

    # -------------------------------------------------------------------------

    name_minutes_seconds:
      description: "Start a timer with a name for a duration of minutes and seconds"
      importance: "complete"
      slots:
        - "name"
        - "minutes"
        - "seconds"
      wildcard_slots:
        - "name"
      example: "set a timer for 10 minutes and 30 seconds named pizza"

    # -------------------------------------------------------------------------
    # conversation_command
    # -------------------------------------------------------------------------

    command_hours:
      description: "Execute a command after a duration of hours"
      importance: "optional"
      slots:
        - "conversation_command"
        - "hours"
      example: "turn off the lights in 1 hour"

    # -------------------------------------------------------------------------

    command_minutes:
      description: "Execute a command after a duration of minutes"
      importance: "optional"
      slots:
        - "conversation_command"
        - "minutes"
      example: "turn off the lights in 10 minutes"

    # -------------------------------------------------------------------------

    command_seconds:
      description: "Execute a command after a duration of seconds"
      importance: "optional"
      slots:
        - "conversation_command"
        - "seconds"
      example: "turn off the lights in 30 seconds"

    # -------------------------------------------------------------------------

    command_hours_minutes:
      description: "Execute a command after a duration of hours and minutes"
      importance: "optional"
      slots:
        - "conversation_command"
        - "hours"
        - "minutes"
      example: "turn off the lights in 1 hour and 10 minutes"

    # -------------------------------------------------------------------------

    command_hours_seconds:
      description: "Execute a command after a duration of hours and seconds"
      importance: "optional"
      slots:
        - "conversation_command"
        - "hours"
        - "seconds"
      example: "turn off the lights in 1 hour and 30 seconds"

    # -------------------------------------------------------------------------

    command_minutes_seconds:
      description: "Execute a command after a duration of minutes and seconds"
      importance: "optional"
      slots:
        - "conversation_command"
        - "minutes"
        - "seconds"
      example: "turn off the lights in 10 minutes and 30 seconds"

# -----------------------------------------------------------------------------

HassCancelAllTimers:
  supported: true
  domain: homeassistant
  description: "Cancels all timers"
  slots:
    area:
      description: "Area of the device used to start the timer"
      required: false
  slot_combinations:
    default:
      description: "Cancels all timers"
      importance: "usable"
      slots: []
      example: "cancel all timers"

    # -------------------------------------------------------------------------

    area_only:
      description: "Cancels all timers in an area"
      importance: "complete"
      slots:
        - "area"
      example: "cancel all timers in the kitchen"

# -----------------------------------------------------------------------------

HassCancelTimer:
  supported: true
  domain: homeassistant
  description: "Cancels a timer"
  slots:
    start_hours:
      description: "Hours the timer was started with"
      required: false
    start_minutes:
      description: "Minutes the timer was started with"
      required: false
    start_seconds:
      description: "Seconds the timer was started with"
      required: false
    name:
      description: "Name attached to the timer"
      required: false
    area:
      description: "Area of the device used to start the timer"
      required: false
  slot_combinations:
    # -------------------------------------------------------------------------
    # Usable slot combinations
    # -------------------------------------------------------------------------

    default:
      description: "Cancels the next timer to elapse"
      importance: "usable"
      slots: []
      example: "cancel my timer"

    # -------------------------------------------------------------------------
    # Optional slot combinations
    # -------------------------------------------------------------------------

    name_only:
      description: "Cancels a timer by name"
      importance: "complete"
      slots:
        - "name"
      wildcard_slots:
        - "name"
      example: "cancel the pizza timer"

    # -------------------------------------------------------------------------

    area_only:
      description: "Cancels the next timer to elapse in an area"
      importance: "complete"
      slots:
        - "area"
      example: "cancel the kitchen timer"

    # -------------------------------------------------------------------------

    hours_only:
      description: "Cancels a timer originally set for a duration of hours"
      importance: "usable"
      slots:
        - "start_hours"
      example: "cancel the 1 hour timer"

    # -------------------------------------------------------------------------

    minutes_only:
      description: "Cancels a timer originally set for a duration of minutes"
      importance: "usable"
      slots:
        - "start_minutes"
      example: "cancel the 10 minute timer"

    # -------------------------------------------------------------------------

    seconds_only:
      description: "Cancels a timer originally set for a duration of seconds"
      importance: "usable"
      slots:
        - "start_seconds"
      example: "cancel the 30 second timer"

# -----------------------------------------------------------------------------

HassIncreaseTimer:
  supported: true
  domain: homeassistant
  description: "Adds time to a timer"
  slots:
    hours:
      description: "Number of hours"
      required: false
    minutes:
      description: "Number of minutes"
      required: false
    seconds:
      description: "Number of seconds"
      required: false
    start_hours:
      description: "Hours the timer was started with"
      required: false
    start_minutes:
      description: "Minutes the timer was started with"
      required: false
    start_seconds:
      description: "Seconds the timer was started with"
      required: false
    name:
      description: "Name attached to the timer"
      required: false
    area:
      description: "Area of the device used to start the timer"
      required: false
  slot_combinations:
    hours_only:
      description: "Add hours to the most recent timer"
      importance: "complete"
      slots:
        - "hours"
      example: "add 1 hour to my timer"

    # -------------------------------------------------------------------------

    minutes_only:
      description: "Add minutes to the most recent timer"
      importance: "complete"
      slots:
        - "minutes"
      example: "add 10 minutes to my timer"

    # -------------------------------------------------------------------------

    seconds_only:
      description: "Add seconds to the most recent timer"
      importance: "complete"
      slots:
        - "seconds"
      example: "add 30 seconds to my timer"

    # -------------------------------------------------------------------------
    # name
    # -------------------------------------------------------------------------

    name_hours:
      description: "Add hours to a timer by name"
      importance: "complete"
      slots:
        - "name"
        - "hours"
      wildcard_slots:
        - "name"
      example: "add 1 hour to the pizza timer"

    # -------------------------------------------------------------------------

    name_minutes:
      description: "Add minutes to a timer by name"
      importance: "complete"
      slots:
        - "name"
        - "minutes"
      wildcard_slots:
        - "name"
      example: "add 10 minutes to the pizza timer"

    # -------------------------------------------------------------------------

    name_seconds:
      description: "Add seconds to a timer by name"
      importance: "complete"
      slots:
        - "name"
        - "seconds"
      wildcard_slots:
        - "name"
      example: "add 30 seconds to the pizza timer"

    # -------------------------------------------------------------------------
    # area
    # -------------------------------------------------------------------------

    area_hours:
      description: "Add hours to the most recent timer in an area"
      importance: "complete"
      slots:
        - "area"
        - "hours"
      example: "add 1 hour to the kitchen timer"

    # -------------------------------------------------------------------------

    area_minutes:
      description: "Add minutes to the most recent timer in an area"
      importance: "complete"
      slots:
        - "area"
        - "minutes"
      example: "add 10 minutes to the kitchen timer"

    # -------------------------------------------------------------------------

    area_seconds:
      description: "Add seconds to the most recent timer in an area"
      importance: "complete"
      slots:
        - "area"
        - "seconds"
      example: "add 30 seconds to the kitchen timer"

    # -------------------------------------------------------------------------
    # hours + start
    # -------------------------------------------------------------------------

    hours_start_hours:
      description: "Add hours to the timer that was started with a duration of hours"
      importance: "complete"
      slots:
        - "start_hours"
        - "hours"
      example: "add 1 hour to the 2 hour timer"

    # -------------------------------------------------------------------------

    hours_start_minutes:
      description: "Add hours to the timer that was started with a duration of minutes"
      importance: "complete"
      slots:
        - "start_minutes"
        - "hours"
      example: "add 1 hour to the 10 minute timer"

    # -------------------------------------------------------------------------

    hours_start_seconds:
      description: "Add hours to the timer that was started with a duration of seconds"
      importance: "complete"
      slots:
        - "start_seconds"
        - "hours"
      example: "add 1 hour to the 30 second timer"

    # -------------------------------------------------------------------------
    # minutes + start
    # -------------------------------------------------------------------------

    minutes_start_hours:
      description: "Add minutes to the timer that was started with a duration of hours"
      importance: "complete"
      slots:
        - "start_hours"
        - "minutes"
      example: "add 10 minutes to my timer"

    # -------------------------------------------------------------------------

    minutes_start_minutes:
      description: "Add minutes to the timer that was started with a duration of minutes"
      importance: "complete"
      slots:
        - "start_minutes"
        - "minutes"
      example: "add 10 minutes to the 20 minute timer"

    # -------------------------------------------------------------------------

    minutes_start_seconds:
      description: "Add minutes to the timer that was started with a duration of seconds"
      importance: "complete"
      slots:
        - "start_seconds"
        - "minutes"
      example: "add 10 minutes to the 40 second timer"

    # -------------------------------------------------------------------------
    # seconds + start
    # -------------------------------------------------------------------------

    seconds_start_hours:
      description: "Add seconds to the timer that was started with a duration of hours"
      importance: "complete"
      slots:
        - "start_hours"
        - "seconds"
      example: "add 30 seconds to my timer"

    # -------------------------------------------------------------------------

    seconds_start_minutes:
      description: "Add seconds to the timer that was started with a duration of minutes"
      importance: "complete"
      slots:
        - "start_minutes"
        - "seconds"
      example: "add 30 seconds to the 20 minute timer"

    # -------------------------------------------------------------------------

    seconds_start_seconds:
      description: "Add seconds to the timer that was started with a duration of seconds"
      importance: "complete"
      slots:
        - "start_seconds"
        - "seconds"
      example: "add 30 seconds to the 40 second timer"

# -----------------------------------------------------------------------------

HassDecreaseTimer:
  supported: true
  domain: homeassistant
  description: "Removes time from a timer"
  slots:
    hours:
      description: "Number of hours"
      required: false
    minutes:
      description: "Number of minutes"
      required: false
    seconds:
      description: "Number of seconds"
      required: false
    start_hours:
      description: "Hours the timer was started with"
      required: false
    start_minutes:
      description: "Minutes the timer was started with"
      required: false
    start_seconds:
      description: "Seconds the timer was started with"
      required: false
    name:
      description: "Name attached to the timer"
      required: false
    area:
      description: "Area of the device used to start the timer"
      required: false
  slot_combinations:
    hours_only:
      description: "Remove hours from the most recent timer"
      importance: "complete"
      slots:
        - "hours"
      example: "remove 1 hour to my timer"

    # -------------------------------------------------------------------------

    minutes_only:
      description: "Remove minutes from the most recent timer"
      importance: "complete"
      slots:
        - "minutes"
      example: "remove 10 minutes to my timer"

    # -------------------------------------------------------------------------

    seconds_only:
      description: "Remove seconds from the most recent timer"
      importance: "complete"
      slots:
        - "seconds"
      example: "remove 30 seconds to my timer"

    # -------------------------------------------------------------------------

    hours_minutes:
      description: "Remove hours and minutes from the most recent timer"
      importance: "complete"
      slots:
        - "hours"
        - "minutes"
      example: "remove 1 hour and 10 minutes to my timer"

    # -------------------------------------------------------------------------

    hours_seconds:
      description: "Remove hours and seconds from the most recent timer"
      importance: "complete"
      slots:
        - "hours"
        - "seconds"
      example: "remove 1 hour and 30 seconds to my timer"

    # -------------------------------------------------------------------------

    minutes_seconds:
      description: "Remove minutes and seconds from the most recent timer"
      importance: "complete"
      slots:
        - "minutes"
        - "seconds"
      example: "remove 10 minutes and 30 seconds to my timer"

    # -------------------------------------------------------------------------
    # name
    # -------------------------------------------------------------------------

    name_hours:
      description: "Remove hours to a timer by name"
      importance: "complete"
      slots:
        - "name"
        - "hours"
      wildcard_slots:
        - "name"
      example: "remove 1 hour from the pizza timer"

    # -------------------------------------------------------------------------

    name_minutes:
      description: "Remove minutes to a timer by name"
      importance: "complete"
      slots:
        - "name"
        - "minutes"
      wildcard_slots:
        - "name"
      example: "remove 10 minutes from the pizza timer"

    # -------------------------------------------------------------------------

    name_seconds:
      description: "Remove seconds to a timer by name"
      importance: "complete"
      slots:
        - "name"
        - "seconds"
      wildcard_slots:
        - "name"
      example: "remove 30 seconds from the pizza timer"

    # -------------------------------------------------------------------------

    name_hours_minutes:
      description: "Remove hours and minutes to a timer by name"
      importance: "complete"
      slots:
        - "name"
        - "hours"
        - "minutes"
      wildcard_slots:
        - "name"
      example: "remove 1 hour and 10 minutes from the pizza timer"

    # -------------------------------------------------------------------------

    name_hours_seconds:
      description: "Remove hours and seconds to a timer by name"
      importance: "complete"
      slots:
        - "name"
        - "hours"
        - "seconds"
      wildcard_slots:
        - "name"
      example: "remove 1 hour and 30 seconds from the pizza timer"

    # -------------------------------------------------------------------------
    # area
    # -------------------------------------------------------------------------

    area_hours:
      description: "Remove hours from the most recent timer in an area"
      importance: "complete"
      slots:
        - "area"
        - "hours"
      example: "remove 1 hour from the kitchen timer"

    # -------------------------------------------------------------------------

    area_minutes:
      description: "Remove minutes from the most recent timer in an area"
      importance: "complete"
      slots:
        - "area"
        - "minutes"
      example: "remove 10 minutes from the kitchen timer"

    # -------------------------------------------------------------------------

    area_seconds:
      description: "Remove seconds from the most recent timer in an area"
      importance: "complete"
      slots:
        - "area"
        - "seconds"
      example: "remove 30 seconds from the kitchen timer"

    # -------------------------------------------------------------------------

    area_minutes_seconds:
      description: "Remove minutes and seconds from the most recent timer in an area"
      importance: "complete"
      slots:
        - "area"
        - "minutes"
        - "seconds"
      example: "remove 10 minutes and 30 seconds from the kitchen timer"

    # -------------------------------------------------------------------------

    area_hours_minutes:
      description: "Remove hours and minutes from the most recent timer in an area"
      importance: "complete"
      slots:
        - "area"
        - "hours"
        - "minutes"
      example: "remove 1 hour and 10 minutes from the kitchen timer"

    # -------------------------------------------------------------------------

    area_hours_seconds:
      description: "Remove hours and seconds from the most recent timer in an area"
      importance: "complete"
      slots:
        - "area"
        - "hours"
        - "seconds"
      example: "remove 1 hour and 30 seconds from the kitchen timer"

    # -------------------------------------------------------------------------
    # hours + start
    # -------------------------------------------------------------------------

    hours_start_hours:
      description: "Remove hours from the timer that was started with a duration of hours"
      importance: "complete"
      slots:
        - "start_hours"
        - "hours"
      example: "remove 1 hour from the 2 hour timer"

    # -------------------------------------------------------------------------

    hours_start_minutes:
      description: "Remove hours from the timer that was started with a duration of minutes"
      importance: "complete"
      slots:
        - "start_minutes"
        - "hours"
      example: "remove 1 hour from the 10 minute timer"

    # -------------------------------------------------------------------------

    hours_start_seconds:
      description: "Remove hours from the timer that was started with a duration of seconds"
      importance: "complete"
      slots:
        - "start_seconds"
        - "hours"
      example: "remove 1 hour from the 30 second timer"

    # -------------------------------------------------------------------------
    # minutes + start
    # -------------------------------------------------------------------------

    minutes_start_hours:
      description: "Remove minutes from the timer that was started with a duration of hours"
      importance: "complete"
      slots:
        - "start_hours"
        - "minutes"
      example: "remove 10 minutes to my timer"

    # -------------------------------------------------------------------------

    minutes_start_minutes:
      description: "Remove minutes from the timer that was started with a duration of minutes"
      importance: "complete"
      slots:
        - "start_minutes"
        - "minutes"
      example: "remove 10 minutes from the 20 minute timer"

    # -------------------------------------------------------------------------

    minutes_start_seconds:
      description: "Remove minutes from the timer that was started with a duration of seconds"
      importance: "complete"
      slots:
        - "start_seconds"
        - "minutes"
      example: "remove 10 minutes from the 40 second timer"

    # -------------------------------------------------------------------------
    # seconds + start
    # -------------------------------------------------------------------------

    seconds_start_hours:
      description: "Remove seconds from the timer that was started with a duration of hours"
      importance: "complete"
      slots:
        - "start_hours"
        - "seconds"
      example: "remove 30 seconds to my timer"

    # -------------------------------------------------------------------------

    seconds_start_minutes:
      description: "Remove seconds from the timer that was started with a duration of minutes"
      importance: "complete"
      slots:
        - "start_minutes"
        - "seconds"
      example: "remove 30 seconds from the 20 minute timer"

    # -------------------------------------------------------------------------

    seconds_start_seconds:
      description: "Remove seconds from the timer that was started with a duration of seconds"
      importance: "complete"
      slots:
        - "start_seconds"
        - "seconds"
      example: "remove 30 seconds from the 40 second timer"

# -----------------------------------------------------------------------------

HassPauseTimer:
  supported: true
  domain: homeassistant
  description: "Pauses a running timer"
  slots:
    start_hours:
      description: "Hours the timer was started with"
      required: false
    start_minutes:
      description: "Minutes the timer was started with"
      required: false
    start_seconds:
      description: "Seconds the timer was started with"
      required: false
    name:
      description: "Name attached to the timer"
      required: false
    area:
      description: "Area of the device used to start the timer"
      required: false
  slot_combinations:
    default:
      description: "Pause the most recent timer"
      importance: "usable"
      slots: []
      example: "pause my timer"

    # -------------------------------------------------------------------------

    name_only:
      description: "Pause a timer by name"
      importance: "complete"
      slots:
        - "name"
      wildcard_slots:
        - "name"
      example: "pause the pizza timer"

    # -------------------------------------------------------------------------

    area_only:
      description: "Pause the most recent timer in an area"
      importance: "complete"
      slots:
        - "area"
      example: "pause the kitchen timer"

    # -------------------------------------------------------------------------

    hours_only:
      description: "Pause a timer that was started with a duration of hours"
      importance: "complete"
      slots:
        - "start_hours"
      example: "pause the 1 hour timer"

    # -------------------------------------------------------------------------

    minutes_only:
      description: "Pause a timer that was started with a duration of minutes"
      importance: "complete"
      slots:
        - "start_minutes"
      example: "pause the 10 minute timer"

    # -------------------------------------------------------------------------

    seconds_only:
      description: "Pause a timer that was started with a duration of seconds"
      importance: "complete"
      slots:
        - "start_seconds"
      example: "pause the 30 second timer"

# -----------------------------------------------------------------------------

HassUnpauseTimer:
  supported: true
  domain: homeassistant
  description: "Resumes a paused timer"
  slots:
    start_hours:
      description: "Hours the timer was started with"
      required: false
    start_minutes:
      description: "Minutes the timer was started with"
      required: false
    start_seconds:
      description: "Seconds the timer was started with"
      required: false
    name:
      description: "Name attached to the timer"
      required: false
    area:
      description: "Area of the device used to start the timer"
      required: false
  slot_combinations:
    default:
      description: "Resume the most recent timer"
      importance: "usable"
      slots: []
      example: "resume my timer"

    # -------------------------------------------------------------------------

    name_only:
      description: "Resume a timer by name"
      importance: "complete"
      slots:
        - "name"
      wildcard_slots:
        - "name"
      example: "resume the pizza timer"

    # -------------------------------------------------------------------------

    area_only:
      description: "Resume the most recent timer in an area"
      importance: "complete"
      slots:
        - "area"
      example: "resume the kitchen timer"

    # -------------------------------------------------------------------------

    hours_only:
      description: "Resume a timer that was started with a duration of hours"
      importance: "complete"
      slots:
        - "start_hours"
      example: "resume the 1 hour timer"

    # -------------------------------------------------------------------------

    minutes_only:
      description: "Resume a timer that was started with a duration of minutes"
      importance: "complete"
      slots:
        - "start_minutes"
      example: "resume the 10 minute timer"

    # -------------------------------------------------------------------------

    seconds_only:
      description: "Resume a timer that was started with a duration of seconds"
      importance: "complete"
      slots:
        - "start_seconds"
      example: "resume the 30 second timer"

# -----------------------------------------------------------------------------

HassTimerStatus:
  supported: true
  domain: homeassistant
  description: "Reports status of one or more timers"
  slots:
    start_hours:
      description: "Hours the timer was started with"
      required: false
    start_minutes:
      description: "Minutes the timer was started with"
      required: false
    start_seconds:
      description: "Seconds the timer was started with"
      required: false
    name:
      description: "Name attached to the timer"
      required: false
    area:
      description: "Area of the device used to start the timer"
      required: false
  slot_combinations:
    # -------------------------------------------------------------------------
    # Usable slot combinations
    # -------------------------------------------------------------------------

    default:
      description: "Get status of all timers"
      importance: "usable"
      slots: []
      example: "how much time is left on my timer"

    # -------------------------------------------------------------------------
    # Optional slot combinations
    # -------------------------------------------------------------------------

    name_only:
      description: "Get status of a timer by name"
      importance: "complete"
      slots:
        - "name"
      wildcard_slots:
        - "name"
      example: "how much time is left on the pizza timer"

    # -------------------------------------------------------------------------

    area_only:
      description: "Get status of all timers in an area"
      importance: "complete"
      slots:
        - "area"
      example: "how much time is left on the kitchen timer"

    # -------------------------------------------------------------------------

    hours_only:
      description: "Get status of all timers that was started with a duration of hours"
      importance: "complete"
      slots:
        - "start_hours"
      example: "how much time is left on the 1 hour timer"

    # -------------------------------------------------------------------------

    minutes_only:
      description: "Get status of all timers that was started with a duration of minutes"
      slots:
        - "start_minutes"
      importance: "complete"
      example: "how much time is left on the 10 minute timer"

    # -------------------------------------------------------------------------

    seconds_only:
      description: "Get status of all timers that was started with a duration of seconds"
      importance: "complete"
      slots:
        - "start_seconds"
      example: "how much time is left on the 30 second timer"

  response_variables:
    timers:
      description: |
        List of timer objects with:
          - is_active: true if timer is running (not paused)
          - name: name of the timer (optional)
          - area: area name of the device used to start the timer (optional)
          - total_seconds_left: seconds remaining for timer
          - rounded_hours_left: hours remaining for timer (rounded)
          - rounded_minutes_left: minutes remaining for timer (rounded)
          - rounded_seconds_left: seconds remaining for timer (rounded)
          - start_hours: hours that the timer was started with
          - start_minutes: minutes that the timer was started with
          - start_seconds: seconds that the timer was started with