feat(hass): add timer duration voice command

devices/homie/modules/home-assistant/docs/functions.nix

@@ -1,6 +1,7 @@
 # I use nix2yaml from ../default.nix to convert this to YAML and place it in the functions of extended_ollama_conversation
 let
-  inherit (builtins) concatStringsSep;
+  inherit (import ../../../../../lib {}) lib;
+  inherit (lib) concatStrings concatStringsSep splitString;
 in [
   {
     spec = {
@@ -42,7 +43,7 @@ in [
           target.entity_id = "timer.assist_timer1";
 
           data = {
-            duration = concatStringsSep "" [
+            duration = concatStrings [
               ''{% if not hours %} {% set hours = "0" %} {% endif %}''
               ''{% if not minutes %} {% set minutes = "0" %} {% endif %}''
               ''{% if not seconds %} {% set seconds = "0" %} {% endif %}''
@@ -161,10 +162,93 @@ in [
     };
   }
 
-  /*
-  TimerDuration:
-    async_action: true
-    action:
-      - stop: ""
-  */
+  {
+    spec = {
+      name = "timer_duration";
+      description = "Use this function to get the remaining duration of a timer in Home Assistant.";
+
+      parameters = {
+        type = "object";
+
+        properties = {
+          timer_number = {
+            type = "string";
+            description = "The number of the timer";
+            enum = ["1" "2" "3"];
+          };
+        };
+
+        required = ["timer_number"];
+      };
+    };
+
+    function = {
+      type = "template";
+
+      value_template = concatStringsSep " " (splitString "\n" ''
+        {%- set entity_id = "timer.assist_timer" ~ timer_number %}
+
+        {%- set timer_amount = states.timer
+          | selectattr("state","eq","active")
+          | selectattr("entity_id","match","timer.assist_timer*")
+          | map(attribute="entity_id")
+          | list
+          | length -%}
+
+        {% if timer_amount == 0 %}
+        There are no timers active.
+
+        {% else %}
+          {%- if entity_id != "all" and entity_id != "null" %}
+            {%- set active_timers = states.timer
+              | selectattr("state","eq","active")
+              | selectattr("entity_id","match",entity_id)
+              | list -%}
+
+          {%- else%}
+            {%- set active_timers = states.timer
+              | selectattr("state","eq","active")
+              | selectattr("entity_id","match","timer.assist_timer*")
+              | list -%}
+          {%- endif %}
+
+          {% if active_timers|length == 0 %}
+            {%- if entity_id != "all" and entity_id != "null" %}
+              This timer is not active.
+
+            {%- else %}
+              There are no timers active.
+            {%- endif %}
+
+          {% elif active_timers | length > 1 %}
+            There are {{active_timers|length }} timers active.
+          {% endif %}
+
+          {% for timer in active_timers %}
+            {% set timer_id = timer.entity_id %}
+            {% set timer_finishes_at = state_attr(timer_id, "finishes_at") %}
+            {% set time_remaining = as_datetime(timer_finishes_at) - now() %}
+            {% set hours_remaining = time_remaining.total_seconds() // 3600 %}
+            {% set minutes_remaining = (time_remaining.total_seconds() % 3600) // 60 %}
+            {% set seconds_remaining = time_remaining.total_seconds() % 60 %}
+
+            {% if timer.state == "active" or timer.state == "paused" %}
+              {% if entity_id != timer_id %}
+                {{ state_attr(timer_id, "friendly_name")[9:] }} {% if timer.state == "paused" %} is paused and {% endif %} has
+
+              {% else %}
+               There are
+              {% endif %}
+
+              {% if hours_remaining > 0 %}{{ hours_remaining | round }} hours {% endif %}
+              {% if minutes_remaining == 1 %}1 minute {% endif %}
+              {% if minutes_remaining > 1 %}{{ minutes_remaining | round }} minutes {% endif %}
+              {% if seconds_remaining == 1 and hours_remaining == 0%}1 seconde {% endif %}
+              {% if seconds_remaining > 1 and hours_remaining == 0 %}{{ seconds_remaining | round }} seconds {% endif %}remaining.
+            {% endif %}
+          {% endfor %}
+        {% endif %}
+      '');
+    };
+  }
 ]