home-assistant-intents 2025.6.23__py3-none-any.whl → 2025.8.27__py3-none-any.whl

home_assistant_intents/__init__.py

@@ -7,13 +7,14 @@ import typing
 from dataclasses import dataclass
 from enum import Enum
 from pathlib import Path
-from typing import IO, Any, Callable, Dict, List, Optional
+from typing import IO, Any, Callable, Collection, Dict, List, Optional, Set, Tuple
 
 from .languages import LANGUAGES
 
 _PACKAGE = "home_assistant_intents"
 _DIR = Path(typing.cast(os.PathLike, importlib.resources.files(_PACKAGE)))
 _DATA_DIR = _DIR / "data"
+_FUZZY_DIR = _DIR / "fuzzy"
 
 
 class ErrorKey(str, Enum):
@@ -155,3 +156,136 @@ def get_language_scores(
             )
             for lang_key, lang_scores in scores_dict.items()
         }
+
+
+# -----------------------------------------------------------------------------
+
+
+@dataclass
+class FuzzyConfig:
+    """Shared configuration for fuzzy matching."""
+
+    # intent -> (slot, slot) -> {name domains}
+    slot_combinations: Dict[str, Dict[Tuple[str, ...], Set[str]]]
+    """Name domains for all intent slot combinations."""
+
+    # list name -> [slot names]
+    slot_list_names: Dict[str, List[str]]
+    """Mapping between list and slot names."""
+
+
+@dataclass
+class FuzzyNgramModel:
+    """N-gram model for fuzzy matching."""
+
+    order: int
+    """N-gram order."""
+
+    words: Dict[str, int]
+    """Words to integer ids."""
+
+    database_path: Path
+    """Path to sqlite3 database file."""
+
+
+FuzzyLanguageResponses = Dict[str, Dict[Tuple[str, ...], Dict[str, str]]]
+
+
+@dataclass
+class FuzzyLanguageInfo:
+    """Language specific information for fuzzy matching."""
+
+    language: str
+
+    # domain -> [keywords]
+    domain_keywords: Dict[str, List[str]]
+    """Keywords that hint at a domain."""
+
+    # intent -> model
+    ngram_models: Dict[str, FuzzyNgramModel]
+    """N-gram model for each intent."""
+
+    # intent -> (slot, slot) -> domain -> response
+    responses: FuzzyLanguageResponses
+    """Response code mapping per slot combination."""
+
+    stop_words: Optional[Collection[str]] = None
+    """Words that can be ignored if unknown."""
+
+
+def get_fuzzy_config(
+    json_load: Callable[[IO[str]], Dict[str, Any]] = json.load,
+) -> FuzzyConfig:
+    """Return shared configuration for fuzzy matching."""
+    with open(_FUZZY_DIR / "config.json", "r", encoding="utf-8") as config_file:
+        config_dict = json_load(config_file)
+
+    return FuzzyConfig(
+        slot_combinations={
+            intent_name: {
+                tuple(sorted(combo_key_str.split())): set(name_domains)
+                for combo_key_str, name_domains in intent_combos.items()
+            }
+            for intent_name, intent_combos in config_dict["slot_combinations"].items()
+        },
+        slot_list_names={
+            list_name: slot_names
+            for list_name, slot_names in config_dict["slot_list_names"].items()
+        },
+    )
+
+
+def get_fuzzy_languages() -> Set[str]:
+    """Return languages with fuzzy matching support."""
+    return {lang_dir.name for lang_dir in _FUZZY_DIR.iterdir() if lang_dir.is_dir()}
+
+
+def get_fuzzy_language(
+    language: str,
+    json_load: Callable[[IO[str]], Dict[str, Any]] = json.load,
+) -> Optional[FuzzyLanguageInfo]:
+    """Return fuzzy matching information for a language."""
+    lang_fuzzy_dir = _FUZZY_DIR / language
+    lang_ngram_dir = lang_fuzzy_dir / "ngram"
+
+    if not lang_ngram_dir.is_dir():
+        return None
+
+    with open(lang_fuzzy_dir / "config.json", "r", encoding="utf-8") as config_file:
+        lang_config = json_load(config_file)
+
+    ngram_models: Dict[str, FuzzyNgramModel] = {}
+    for intent_ngram_path in lang_ngram_dir.glob("*.json"):
+        intent_db_path = intent_ngram_path.with_suffix(".db")
+        if not intent_db_path.exists():
+            continue
+
+        with open(intent_ngram_path, "r", encoding="utf-8") as intent_ngram_file:
+            intent_ngram_dict = json_load(intent_ngram_file)
+
+        intent_name = intent_ngram_path.stem
+        ngram_models[intent_name] = FuzzyNgramModel(
+            order=intent_ngram_dict["order"],
+            words=intent_ngram_dict["words"],
+            database_path=intent_db_path,
+        )
+
+    with open(
+        lang_fuzzy_dir / "responses.json", "r", encoding="utf-8"
+    ) as responses_file:
+        lang_responses_dict = json_load(responses_file)
+        lang_responses = {
+            intent_name: {
+                tuple(sorted(combo_key_str.split())): domain_responses
+                for combo_key_str, domain_responses in intent_responses.items()
+            }
+            for intent_name, intent_responses in lang_responses_dict.items()
+        }
+
+    return FuzzyLanguageInfo(
+        language=language,
+        domain_keywords=lang_config["domain_keywords"],
+        stop_words=lang_config.get("stop_words"),
+        ngram_models=ngram_models,
+        responses=lang_responses,
+    )

home_assistant_intents/data/ca.json

@@ -1,6 +1,44 @@
 {
   "language": "ca",
   "intents": {
+    "HassMediaSearchAndPlay": {
+      "data": [
+        {
+          "sentences": [
+            "<reproduir> [el |la |l']{media_class} [de |d']{search_query}",
+            "<reproduir> {search_query} [<pronom_singular>]{media_class}",
+            "<reproduir> {search_query}"
+          ],
+          "requires_context": {
+            "area": {
+              "slot": true
+            }
+          }
+        },
+        {
+          "sentences": [
+            "<reproduir> [el |la |l']{media_class} [de |d']{search_query} [<area>]",
+            "<reproduir> {search_query} [<preposicio_base_singular>] <name> <area>",
+            "<reproduir> {search_query} [el |la |l']{media_class} <area>",
+            "<reproduir> {search_query} <area>"
+          ]
+        },
+        {
+          "sentences": [
+            "<reproduir> {search_query}",
+            "<reproduir> {search_query} [<preposicio_base_singular>] <name>",
+            "<reproduir> [el |la |l']{media_class} [de |d']{search_query} [<preposicio_base_singular>] <name> [<area>]",
+            "<reproduir> {search_query} [el |la |l']{media_class} [<preposicio_base_singular>] <name>",
+            "<reproduir> {search_query} <name>",
+            "<reproduir> {search_query} <name> <area>",
+            "<reproduir> {search_query} <area>"
+          ],
+          "requires_context": {
+            "domain": "media_player"
+          }
+        }
+      ]
+    },
     "HassTurnOff": {
       "data": [
         {
@@ -559,7 +597,7 @@
             "my_list": "[la] [meva] llista [de (la compra|compres|comprar)]",
             "my_list_req": "[la] [meva] llista de (la compra|compres|comprar)",
             "item": "{shopping_list_item:item}",
-            "add": "(afeg[e]ix|posa)"
+            "add": "(afeg[e]ix|posa|fica)"
           }
         }
       ]
@@ -889,7 +927,8 @@
         {
           "sentences": [
             "([Fes un] anunci|anuncia) [a tot arreu] [que digui|dient] [que] {message}",
-            "[Fes un] broadcast [a tot arreu] [que digui|dient] [que] {message}"
+            "[Fes un] broadcast [a tot arreu] [que digui|dient] [que] {message}",
+            "avisa [a tot arreu] [dient] [de que|que] {message}"
           ]
         }
       ]
@@ -943,10 +982,34 @@
       "data": [
         {
           "sentences": [
-            "(<pujar>|<baixar>|<configura>) ([el] (volum|so)|[la] veu) [<preposicio>] {name} [a|al] {volume:volume_level}[<percent>]"
+            "(<pujar>|<baixar>|<configura>) ([el] (volum|so)|[la] veu) [<preposicio>] {name} (a|al) {volume:volume_level}[<percent>]"
           ],
           "requires_context": {
             "domain": "media_player"
+          },
+          "required_keywords": [
+            "a",
+            "al"
+          ]
+        }
+      ]
+    },
+    "HassListCompleteItem": {
+      "data": [
+        {
+          "sentences": [
+            "<completa> <item> de la [meva] llista (de|del|de la|amb nom|anomenada) {name}",
+            "<completa> <item> de <my_list>",
+            "<completa> de <my_list> [un[a|es]|que] <item>"
+          ],
+          "response": "item_completed",
+          "requires_context": {
+            "domain": "todo"
+          },
+          "expansion_rules": {
+            "my_list": "[la] [meva] llista [de|del|de la] {name}",
+            "item": "{todo_list_item:item}",
+            "completa": "(acaba|completa|desmarca|elimina|cancel[·l]a)[r]"
           }
         }
       ]
@@ -976,6 +1039,170 @@
           ]
         }
       ]
+    },
+    "HassSetVolumeRelative": {
+      "data": [
+        {
+          "sentences": [
+            "(<pujar>|posa[r|-li]) [el|més] (volum|so)",
+            "(<pujar>|posa[r|-li]) [la|més] (veu)",
+            "més <volum>"
+          ],
+          "slots": {
+            "volume_step": "up"
+          },
+          "requires_context": {
+            "area": {
+              "slot": true
+            }
+          }
+        },
+        {
+          "sentences": [
+            "(<pujar>|posa[r|-li]) [el|més] (volum|so) [per|un|al] <volume_step>",
+            "(<pujar>|posa[r|-li]) [la|més] (veu) [per|un|al] <volume_step>"
+          ],
+          "expansion_rules": {
+            "volume_step": "{volume_step_up:volume_step}[<percent>]"
+          },
+          "requires_context": {
+            "area": {
+              "slot": true
+            }
+          }
+        },
+        {
+          "sentences": [
+            "(<baixar>) [el|més] (volum|so)",
+            "(<baixar>) [la|més] (veu)",
+            "menys <volum>"
+          ],
+          "slots": {
+            "volume_step": "down"
+          },
+          "requires_context": {
+            "area": {
+              "slot": true
+            }
+          }
+        },
+        {
+          "sentences": [
+            "(<baixar>) [el|més] (volum|so) [per|un|al] <volume_step>",
+            "(<baixar>) [la|més] (veu) [per|un|al] <volume_step>"
+          ],
+          "expansion_rules": {
+            "volume_step": "{volume_step_down:volume_step}[<percent>]"
+          },
+          "requires_context": {
+            "area": {
+              "slot": true
+            }
+          }
+        },
+        {
+          "sentences": [
+            "(<name>;més <volum>)",
+            "(<pujar>) [el|la|més] <volum> [de|del|per|pel|al|a] <name>",
+            "<name> <pujar> [el|la] <volum>"
+          ],
+          "slots": {
+            "volume_step": "up"
+          },
+          "requires_context": {
+            "domain": "media_player"
+          }
+        },
+        {
+          "sentences": [
+            "(<name>;més <volum>) [per|un|al] <volume_step>",
+            "<name>;<volume_step> més [de] <volum>",
+            "(<pujar>) [el|la|més] <volum> [de|del|per|pel|al|a] <name> [per|un|al] <volume_step>",
+            "<name> <pujar> [el|la] <volum> [per|un|al] <volume_step>"
+          ],
+          "expansion_rules": {
+            "volume_step": "{volume_step_up:volume_step}[<percent>]"
+          },
+          "slots": {
+            "volume_step": "up"
+          },
+          "requires_context": {
+            "domain": "media_player"
+          }
+        },
+        {
+          "sentences": [
+            "(<name>;menys <volum>)",
+            "(<baixar>) [el|la] <volum> [de|del|per|pel|al|a] <name>",
+            "<name> <baixar> [el|la] <volum>"
+          ],
+          "slots": {
+            "volume_step": "down"
+          },
+          "requires_context": {
+            "domain": "media_player"
+          }
+        },
+        {
+          "sentences": [
+            "(<name>;menys <volum>) [per|un|al] <volume_step>",
+            "<name>;<volume_step> menys [de] <volum>",
+            "(<baixar>) [el|la] <volum> [de|del|per|pel|al|a] <name> [per|un|al] <volume_step>",
+            "<name> <baixar> [el|la] <volum> [per|un|al] <volume_step>"
+          ],
+          "expansion_rules": {
+            "volume_step": "{volume_step_down:volume_step}[<percent>]"
+          },
+          "slots": {
+            "volume_step": "down"
+          },
+          "requires_context": {
+            "domain": "media_player"
+          }
+        },
+        {
+          "sentences": [
+            "(<area_floor>;més <volum>)",
+            "(<pujar>) [el|la|més] <volum> <area_floor>",
+            "<area_floor> <pujar> [el|la] <volum>"
+          ],
+          "slots": {
+            "volume_step": "up"
+          }
+        },
+        {
+          "sentences": [
+            "(<area_floor>;més <volum>) [per|un|al] <volume_step>",
+            "<area_floor>;<volume_step> més [de] <volum>",
+            "(<pujar>) [el|la|més] <volum> <area_floor> [per|un|al] <volume_step>",
+            "<area_floor> <pujar> [el|la] <volum> [per|un|al] <volume_step>"
+          ],
+          "expansion_rules": {
+            "volume_step": "{volume_step_up:volume_step}[<percent>]"
+          }
+        },
+        {
+          "sentences": [
+            "(<area_floor>;menys <volum>)",
+            "(<baixar>) [el|la] <volum> <area_floor>",
+            "<area_floor> <baixar> [el|la] <volum>"
+          ],
+          "slots": {
+            "volume_step": "down"
+          }
+        },
+        {
+          "sentences": [
+            "(<area_floor>;menys <volum>) [per|un|al] <volume_step>",
+            "<area_floor>;<volume_step> menys [de] <volum>",
+            "(<baixar>) [el|la] <volum> <area_floor> [per|un|al] <volume_step>",
+            "<area_floor> <baixar> [el|la] <volum> [per|un|al] <volume_step>"
+          ],
+          "expansion_rules": {
+            "volume_step": "{volume_step_down:volume_step}[<percent>]"
+          }
+        }
+      ]
     }
   },
   "responses": {
@@ -995,7 +1222,7 @@
         "all": "{% if not query.unmatched: %}\n  Si\n{% else %}\n  {% set no_match = query.unmatched | map(attribute=\"name\") | sort | list %}\n  {% if no_match | length > 4 %}\n    No, ni {{ no_match[:3] | join(\", \") }} ni els altres {{ (no_match | length - 3) }} ho són\n  {% elif no_match | length == 1 %}\n    No, el dispositiu {{ no_match|first }} no\n  {%- else -%}\n    No, ni\n    {% for name in no_match -%}\n      {% if not loop.first and not loop.last %}, {% elif loop.last and not loop.first %} ni {% endif -%}\n      {{ name }}\n    {%- endfor %}\n  {% endif %}\n{% endif %}\n",
         "which": "{% if not query.matched %}\n  Cap dispositiu\n{% else: %}\n  {% set match = query.matched | map(attribute=\"name\") | sort | list %}\n  {% if match | length > 4 %}\n    {{ match[:3] | join(\", \") }} i uns altres {{ (match | length - 3) }} més\n  {% else %}\n    {%- for name in match -%}\n      {% if not loop.first and not loop.last %}, {% elif loop.last and not loop.first %} i {% endif -%}\n      {{ name }}\n    {%- endfor -%}\n  {% endif %}\n{% endif %}\n",
         "how_many": "{{ query.matched | length }}\n",
-        "where": "{% if state == \"not_home\" %}\n  {{ slots.name | capitalize }} és a fora\n{% else %}\n  {{ slots.name | capitalize }} es troba a {{ state.state }}\n{% endif %}\n"
+        "where": "{% if not query.matched %}\n  No conec a ningú que es digui {{ slots.name | capitalize }}\n{% else %}\n  {% if state == \"not_home\" %}\n    {{ slots.name | capitalize }} és a fora\n  {% elif state == \"home\" %}\n    {{ slots.name | capitalize }} és a casa\n  {% else %}\n    {{ slots.name | capitalize }} es troba a {{ state.state }}\n  {% endif %}\n{% endif %}\n"
       },
       "HassTurnOff": {
         "default": "Apago {{ slots.name }}",
@@ -1082,15 +1309,24 @@
       "HassMediaNext": {
         "default": "Reproduint el següent"
       },
+      "HassSetVolumeRelative": {
+        "default": "Volum establert"
+      },
       "HassCancelTimer": {
         "default": "Temporitzador cancel·lat"
       },
+      "HassMediaSearchAndPlay": {
+        "default": "{% if slots.media: %}\nReproduïnt\n{% else: %}\nNo ho trobo\n{% endif %}\n"
+      },
       "HassClimateGetTemperature": {
         "default": "{% set current_temperature = state_attr(state.entity_id, 'current_temperature') %} {% set temperature = state.state if current_temperature is none else current_temperature %} {{ temperature | float | abs | round(1) | replace('.0', '') | replace('.',',') }} {{ 'grau' if temperature | float | abs == 1 else 'graus' }} {{ 'sota zero' if temperature | float < 0 else '' }}\n"
       },
       "HassSetVolume": {
         "default": "Volum establert"
       },
+      "HassListCompleteItem": {
+        "item_completed": "Completat {{ slots.item }}"
+      },
       "HassDecreaseTimer": {
         "default": "Canvio el temporitzador"
       },
@@ -1365,6 +1601,63 @@
     },
     "message": {
       "wildcard": true
+    },
+    "search_query": {
+      "wildcard": true
+    },
+    "media_class": {
+      "values": [
+        {
+          "in": "artista",
+          "out": "artist"
+        },
+        {
+          "in": "(album|àlbum|disc)",
+          "out": "album"
+        },
+        {
+          "in": "(track|pista|peça|cançó|tema)",
+          "out": "track"
+        },
+        {
+          "in": "(playlist|llista de reproducció)",
+          "out": "playlist"
+        },
+        {
+          "in": "(podcast|pòdcast)",
+          "out": "podcast"
+        },
+        {
+          "in": "(peli|pel·lícula|film|vídeo)",
+          "out": "movie"
+        },
+        {
+          "in": "(show|sèrie [de TV|de televisió]|[l']episodi|capítol)",
+          "out": "tv_show"
+        }
+      ]
+    },
+    "fan_speed": {
+      "range": {
+        "type": "percentage",
+        "from": 0,
+        "to": 100
+      }
+    },
+    "volume_step_up": {
+      "range": {
+        "type": "percentage",
+        "from": 0,
+        "to": 100
+      }
+    },
+    "volume_step_down": {
+      "range": {
+        "type": "percentage",
+        "from": 0,
+        "to": 100,
+        "multiplier": -1
+      }
     }
   },
   "expansion_rules": {
@@ -1380,6 +1673,8 @@
     "preposicio": "<preposicio_base> [<pronom>]",
     "name": "[<pronom_singular>]{name}",
     "area": "[<preposicio_singular>]{area}",
+    "floor": "[<preposicio_singular>] [planta|pis] {floor}",
+    "area_floor": "(<area>|<floor>)",
     "quin_es": "(quin|quina|què) és",
     "lluentor": "{brightness}[<percent>]",
     "al_stt_typo": "(del|el|en|o)",
@@ -1394,10 +1689,11 @@
     "llums_typo": "[[d]el[s]|la|les] (juny|junta|junts)",
     "temp": "(temperatura)",
     "graus": "{temperature} [graus]",
-    "pujar": "([a]puja|aixeca)[r|t]",
-    "baixar": "[a]baixa[r|t]",
+    "pujar": "([a]puja|aixeca|posa)[r|t|-li]",
+    "baixar": "[a]baixa[r|t|-li]",
     "configura": "(posa[r]|puja[r]|configura[r]|ajusta[r]|canvia[r]|establ(ir|eix|ix))",
     "posició": "{position}[<percent>]",
+    "fan_speed": "{fan_speed:percentage}[<percent>]",
     "percent": "(%|per[ ]cent)",
     "cancela": "cancel[·l]a[r|t]",
     "seguent": "següent|(proper|pròxim)[a]",
@@ -1413,6 +1709,7 @@
     "again": "([un|una] altr(e|a) (cop|vegada)|de nou)",
     "torna_a": "(torna[r] a)",
     "can_you": "[pots|podries]",
+    "volum": "(volum|so|veu)",
     "temporitzador": "(temporitzador|compte enrere|minuter|cronòmetre)",
     "timer_set": "(posa|crea|comença|inicia|activa|programa|fixa|estableix|engega|<timer_set_typos>)[r|t|'m]",
     "timer_set_typos": "(cosa)",

home_assistant_intents/data/cs.json

@@ -1,6 +1,39 @@
 {
   "language": "cs",
   "intents": {
+    "HassMediaSearchAndPlay": {
+      "data": [
+        {
+          "sentences": [
+            "přehraj {search_query}",
+            "[s]pusť {search_query}",
+            "[pře]hr(e|a)j {search_query}"
+          ],
+          "requires_context": {
+            "area": {
+              "slot": true
+            }
+          }
+        },
+        {
+          "sentences": [
+            "přehraj {search_query} <area>",
+            "[s]pusť {search_query} <area>",
+            "[pře]hr(e|a)j {search_query} <area>"
+          ]
+        },
+        {
+          "sentences": [
+            "přehraj {search_query} <v> {name} [<area>]",
+            "[s]pusť {search_query} <v> {name} [<area>]",
+            "[pře]hr(e|a)j {search_query} <v> {name} [<area>]"
+          ],
+          "requires_context": {
+            "domain": "media_player"
+          }
+        }
+      ]
+    },
     "HassTurnOff": {
       "data": [
         {
@@ -3831,6 +3864,9 @@
       "HassCancelTimer": {
         "default": "Časovač zastaven"
       },
+      "HassMediaSearchAndPlay": {
+        "default": "{% if slots.media: %}\nPřehrávání začíná\n{% else: %}\nNenalezen žádný odpovídající obsah\n{% endif %}\n"
+      },
       "HassClimateGetTemperature": {
         "default": "{% set current_temperature = state_attr(state.entity_id, 'current_temperature') %} {% set temperature = state.state if current_temperature is none else current_temperature %} {% if temperature is not none %}\n  {% set rounded_temp = (temperature | int) if temperature % 1 == 0 else (temperature | float | round(1)) %}\n  {% set degree_word = 'stupeň' if rounded_temp == 1 else 'stupně' if rounded_temp in [2,3,4] or rounded_temp % 1 != 0 else 'stupňů' %}\n  {{ rounded_temp }} {{ degree_word }}\n{% else %}\n  Omlouvám se, ale nemohu zjistit aktuální teplotu.\n{% endif %}\n"
       },

home_assistant_intents/data/da.json

@@ -3267,6 +3267,26 @@
         }
       ]
     },
+    "HassListCompleteItem": {
+      "data": [
+        {
+          "sentences": [
+            "<fuldfør> <punkt> (på|fra|af) <min_liste>",
+            "kryds <punkt> af på <min_liste>",
+            "marker <punkt> som <fuldført> på <min_liste>",
+            "marker <punkt> (på|fra) <min_liste> som <fuldført>"
+          ],
+          "response": "item_completed",
+          "requires_context": {
+            "domain": "todo"
+          },
+          "expansion_rules": {
+            "min_liste": "[min|vores] {name}[n]",
+            "punkt": "{todo_list_item:item}"
+          }
+        }
+      ]
+    },
     "HassClimateSetTemperature": {
       "data": [
         {
@@ -3435,6 +3455,9 @@
       "HassSetVolume": {
         "default": "Lydstyrke indstillet"
       },
+      "HassListCompleteItem": {
+        "item_completed": "Markerede {{ slots.item }} som færdig"
+      },
       "HassDecreaseTimer": {
         "default": "{% set h = slots.hours if slots.hours is defined else none %} {% set m = slots.minutes if slots.minutes is defined else none %} {% set s = slots.seconds if slots.seconds is defined else none %} {% set h_text = h ~ (' time'  if h in [ \"1\", 'one'] else ' timer') if h else '' %} {% set m_text = m ~ (' minut' if m in [ \"1\", 'one'] else ' minutter') if m else '' %} {% set s_text = s ~ (' sekund' if s in [ \"1\", 'one'] else ' sekunder') if s else '' %} {% set text_list = [ h_text, m_text, s_text] | select() | list %} {% set text = text_list[:-1] | join(', ') ~ ' og ' ~ text_list[-1] if text_list | count > 2 else text_list | join(' og ') %} {% set name = (slots.name | trim) if slots.name is defined else '' %} {{ text }} trukket fra {{ name }} nedtællingen\n"
       },