Merge develop into main

.docs/compatibility.md

@@ -4,7 +4,7 @@ The table below describes the compatibility between the integration versions and
 
 | Integration Version | HA Version  Supported | HA Version Not Supported |
 |---------------------|-----------------------|--------------------------|
-| 1.8.0               | 2026.1                | ---                      |
+| 1.8.0               | 2026.1 - 2026.2       | ---                      |
 | 1.7.0               | 2025.12 - 2026.1      | ---                      |
 | 1.6.0               | 2025.11 - 2025.12     | ---                      |
 | 1.5.0               | 2025.10               | 2025.11                  |

CHANGELOG.md

@@ -5,6 +5,14 @@ All remarkable changes for this project will be documented here.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/) 
 and this project adheres to [SemVer](https://semver.org).
 
+---
+## [1.8.1] - 2026-02-16
+
+### fix
+- Fix action hassfest
+  `[TRANSLATIONS] Invalid translations/en.json: the string should not contain URLs, please use description placeholders instead for dictionary value @ data['config_subentries']['knowledge_source']['step']['reconfigure']['description']`
+  - Removing URLs from the [lang].json file
+
 ---
 ## [1.8.0] - 2026-01-20
 

custom_components/stackspot/config_flow.py

@@ -51,6 +51,10 @@
     CONF_AGENT_ALLOW_CONTROL,
     CONF_AGENT_ALLOW_CONTROL_DEFAULT,
     CONF_LLM_MODEL,
+    PLACEHOLDER_KS_URL,
+    CONF_KS_BASE_URL,
+    PLACEHOLDER_KS_DOC_URL,
+    CONF_KS_DOC_URL,
 )
 from .util import create_slug
 
@@ -316,7 +320,10 @@ async def async_step_user(self, user_input=None):
 
         return self.async_show_form(
             step_id="user",
-            data_schema=_get_schema_subentry_ks()
+            data_schema=_get_schema_subentry_ks(),
+            description_placeholders={
+                PLACEHOLDER_KS_DOC_URL: CONF_KS_DOC_URL
+            }
         )
 
     async def async_step_reconfigure(
@@ -354,6 +361,6 @@ async def async_step_reconfigure(
             data_schema=data_schema,
             description_placeholders={
                 CONF_KS_NAME: current_data.get(CONF_KS_NAME, STATE_UNKNOWN),
-                CONF_KS_SLUG: slug
+                PLACEHOLDER_KS_URL: CONF_KS_BASE_URL.replace('{ks_slug}', slug)
             }
         )

custom_components/stackspot/const.py

@@ -42,6 +42,10 @@
 )
 
 # CONF KS
+CONF_KS_BASE_URL = 'https://ai.stackspot.com/knowledge-sources/{ks_slug}?tabIndex=0'
+CONF_KS_DOC_URL = 'https://ai.stackspot.com/docs/knowledge-source/ks'
+PLACEHOLDER_KS_URL = 'ks_url'
+PLACEHOLDER_KS_DOC_URL = 'ks_doc_url'
 CONF_KS_NAME = 'ks_name'
 CONF_KS_NAME_DEFAULT = 'HA: Entities'
 CONF_KS_SLUG = 'ks_slug'

custom_components/stackspot/manifest.json

@@ -15,5 +15,5 @@
   "iot_class": "cloud_polling",
   "issue_tracker": "https://github.com/alves-dev/stackspot-homeassistant/issues",
   "requirements": ["aiofiles==24.1.0"],
-  "version": "1.8.0"
+  "version": "1.8.1"
 }

custom_components/stackspot/translations/en.json

@@ -116,7 +116,7 @@
       "step": {
         "user": {
           "title": "StackSpot - New Knowledge Source",
-          "description": "KS are used to give agents more context, please read: https://ai.stackspot.com/docs/knowledge-source/ks \nAfter creating KS you should access Stackspot there and link it to your agent",
+          "description": "KS are used to give agents more context, please read: {ks_doc_url} \nAfter creating KS you should access Stackspot there and link it to your agent",
           "data": {
             "ks_name": "KS name",
             "ks_template": "Template",
@@ -129,7 +129,7 @@
         },
         "reconfigure": {
           "title": "StackSpot - Change KS {ks_name}",
-          "description": "Access the KS: https://ai.stackspot.com/knowledge-sources/{ks_slug}?tabIndex=0",
+          "description": "Access the KS: {ks_url}",
           "data": {
             "ks_name": "KS name",
             "ks_template": "Template",

custom_components/stackspot/translations/pt-BR.json

@@ -116,7 +116,7 @@
       "step": {
         "user": {
           "title": "StackSpot - Novo Knowledge Source",
-          "description": "Os Ks são usados para dar aos agentes mais contexto, leia: https://ai.stackspot.com/docs/pt-br/knowledge-source/ks \n Depois de criar KS, você deve acessar a Stackspot e vincular-o ao seu agente",
+          "description": "Os Ks são usados para dar aos agentes mais contexto, leia: {ks_doc_url} \n Depois de criar KS, você deve acessar a Stackspot e vincular-o ao seu agente",
           "data": {
             "ks_name": "Nome do KS",
             "ks_template": "Template",
@@ -129,7 +129,7 @@
         },
         "reconfigure": {
           "title": "StackSpot - Alterando o KS {ks_name}",
-          "description": "Acesse o KS: https://ai.stackspot.com/knowledge-sources/{ks_slug}?tabindex=0",
+          "description": "Acesse o KS: {ks_url}",
           "data": {
             "ks_name": "Nome do KS",
             "ks_template": "Template",