Release v2.1.0

- Fixed version reading from manifest.json implementation

.gitignore

@@ -38,3 +38,4 @@ Thumbs.db
 *.psd
 *.zip
 *.txt
+*.pdf

CODE_OF_CONDUCT.md

@@ -0,0 +1,128 @@
+# Contributor Covenant Code of Conduct
+
+## Our Pledge
+
+We as members, contributors, and leaders pledge to make participation in our
+community a harassment-free experience for everyone, regardless of age, body
+size, visible or invisible disability, ethnicity, sex characteristics, gender
+identity and expression, level of experience, education, socio-economic status,
+nationality, personal appearance, race, religion, or sexual identity
+and orientation.
+
+We pledge to act and interact in ways that contribute to an open, welcoming,
+diverse, inclusive, and healthy community.
+
+## Our Standards
+
+Examples of behavior that contributes to a positive environment for our
+community include:
+
+* Demonstrating empathy and kindness toward other people
+* Being respectful of differing opinions, viewpoints, and experiences
+* Giving and gracefully accepting constructive feedback
+* Accepting responsibility and apologizing to those affected by our mistakes,
+  and learning from the experience
+* Focusing on what is best not just for us as individuals, but for the
+  overall community
+
+Examples of unacceptable behavior include:
+
+* The use of sexualized language or imagery, and sexual attention or
+  advances of any kind
+* Trolling, insulting or derogatory comments, and personal or political attacks
+* Public or private harassment
+* Publishing others' private information, such as a physical or email
+  address, without their explicit permission
+* Other conduct which could reasonably be considered inappropriate in a
+  professional setting
+
+## Enforcement Responsibilities
+
+Community leaders are responsible for clarifying and enforcing our standards of
+acceptable behavior and will take appropriate and fair corrective action in
+response to any behavior that they deem inappropriate, threatening, offensive,
+or harmful.
+
+Community leaders have the right and responsibility to remove, edit, or reject
+comments, commits, code, wiki edits, issues, and other contributions that are
+not aligned to this Code of Conduct, and will communicate reasons for moderation
+decisions when appropriate.
+
+## Scope
+
+This Code of Conduct applies within all community spaces, and also applies when
+an individual is officially representing the community in public spaces.
+Examples of representing our community include using an official e-mail address,
+posting via an official social media account, or acting as an appointed
+representative at an online or offline event.
+
+## Enforcement
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be
+reported to the community leaders responsible for enforcement at
+issue tracker.
+All complaints will be reviewed and investigated promptly and fairly.
+
+All community leaders are obligated to respect the privacy and security of the
+reporter of any incident.
+
+## Enforcement Guidelines
+
+Community leaders will follow these Community Impact Guidelines in determining
+the consequences for any action they deem in violation of this Code of Conduct:
+
+### 1. Correction
+
+**Community Impact**: Use of inappropriate language or other behavior deemed
+unprofessional or unwelcome in the community.
+
+**Consequence**: A private, written warning from community leaders, providing
+clarity around the nature of the violation and an explanation of why the
+behavior was inappropriate. A public apology may be requested.
+
+### 2. Warning
+
+**Community Impact**: A violation through a single incident or series
+of actions.
+
+**Consequence**: A warning with consequences for continued behavior. No
+interaction with the people involved, including unsolicited interaction with
+those enforcing the Code of Conduct, for a specified period of time. This
+includes avoiding interactions in community spaces as well as external channels
+like social media. Violating these terms may lead to a temporary or
+permanent ban.
+
+### 3. Temporary Ban
+
+**Community Impact**: A serious violation of community standards, including
+sustained inappropriate behavior.
+
+**Consequence**: A temporary ban from any sort of interaction or public
+communication with the community for a specified period of time. No public or
+private interaction with the people involved, including unsolicited interaction
+with those enforcing the Code of Conduct, is allowed during this period.
+Violating these terms may lead to a permanent ban.
+
+### 4. Permanent Ban
+
+**Community Impact**: Demonstrating a pattern of violation of community
+standards, including sustained inappropriate behavior,  harassment of an
+individual, or aggression toward or disparagement of classes of individuals.
+
+**Consequence**: A permanent ban from any sort of public interaction within
+the community.
+
+## Attribution
+
+This Code of Conduct is adapted from the [Contributor Covenant][homepage],
+version 2.0, available at
+https://www.contributor-covenant.org/version/2/0/code_of_conduct.html.
+
+Community Impact Guidelines were inspired by [Mozilla's code of conduct
+enforcement ladder](https://github.com/mozilla/diversity).
+
+[homepage]: https://www.contributor-covenant.org
+
+For answers to common questions about this code of conduct, see the FAQ at
+https://www.contributor-covenant.org/faq. Translations are available at
+https://www.contributor-covenant.org/translations.

README.md

@@ -2,9 +2,11 @@
 
 <div align="center">  
 
-![GitHub release](https://img.shields.io/github/release/smkrv/ha-text-ai.svg?style=flat-square) ![GitHub last commit](https://img.shields.io/github/last-commit/smkrv/ha-text-ai.svg?style=flat-square) [![License: CC BY-NC-SA 4.0](https://img.shields.io/badge/License-CC%20BY--NC--SA%204.0-lightgrey.svg?style=flat-square)](https://creativecommons.org/licenses/by-nc-sa/4.0/) [![hacs_badge](https://img.shields.io/badge/HACS-Custom-41BDF5.svg?style=flat-square)](https://github.com/hacs/integration) ![/README.md](https://img.shields.io/badge/language-English-green?style=flat-square) ![/README_RU.md](https://img.shields.io/badge/language-Russian-green?style=flat-square) ![](https://img.shields.io/badge/language-Deutch-green?style=flat-square)
+  ![GitHub release](https://img.shields.io/github/release/smkrv/ha-text-ai.svg?style=flat-square) ![GitHub last commit](https://img.shields.io/github/last-commit/smkrv/ha-text-ai.svg?style=flat-square) [![License: CC BY-NC-SA 4.0](https://img.shields.io/badge/License-CC%20BY--NC--SA%204.0-lightgrey.svg?style=flat-square)](https://creativecommons.org/licenses/by-nc-sa/4.0/) [![hacs_badge](https://img.shields.io/badge/HACS-Custom-41BDF5.svg?style=flat-square)](https://github.com/hacs/integration)  
+![Deutsch](https://img.shields.io/badge/de-Deutsch-blue?style=flat-square) ![English](https://img.shields.io/badge/en-English-blue?style=flat-square) ![Español](https://img.shields.io/badge/es-Español-blue?style=flat-square) ![हिन्दी](https://img.shields.io/badge/hi-हिन्दी-blue?style=flat-square) ![Italiano](https://img.shields.io/badge/it-Italiano-blue?style=flat-square) ![Русский](https://img.shields.io/badge/ru-Русский-blue?style=flat-square) ![Српски](https://img.shields.io/badge/sr-Српски-blue?style=flat-square) ![中文](https://img.shields.io/badge/zh-中文-blue?style=flat-square)
 
-  <img src="https://github.com/smkrv/ha-text-ai/blob/2aaf3405759eb2d97624834594e24ace896131df/assets/images/icons/logo.png" alt="HA Text AI" style="width: 80%; max-width: 640px; max-height: 150px; aspect-ratio: 2/1; object-fit: contain;"/>
+
+  <img src="https://github.com/smkrv/ha-text-ai/blob/15c717fcb0204bf4a0d4b4b4c6f0bb93e9f6c9a9/custom_components/ha_text_ai/icons/logo%402x.png" alt="HA Text AI" style="width: 50%; max-width: 256px; max-height: 128px; aspect-ratio: 2/1; object-fit: contain;"/>
 
 ### Advanced AI Integration for [Home Assistant](https://www.home-assistant.io/) with LLM multi-provider support
 </div>
@@ -32,7 +34,7 @@ Transform your smart home experience with powerful AI assistance powered by mult
 - 🎯 **Advanced Customization**: Per-request model and parameter selection
 - 🔒 **Enhanced Security**: Secure API key management and usage monitoring
 - 🎨 **Improved User Experience**: Intuitive configuration and rich interfaces
-- 🔄 **Automation Integration**: Event-driven responses and template compatibility 
+- 🔄 **Automation Integration**: Event-driven responses and template compatibility
 
 <details>
 <summary>📦 Detailed Feature Breakdown</summary>
@@ -164,6 +166,8 @@ To be compatible, a provider should support:
 7. Click "Download"
 8. Restart Home Assistant
 
+Note: Also Integration has been submitted to HACS store and is currently pending review in [pull request #2896](https://github.com/hacs/default/pull/2896).
+
 ### Manual Installation
 1. Download the latest release
 2. Extract and copy `custom_components/ha_text_ai` to your `custom_components` directory
@@ -270,6 +274,8 @@ data:
 ### clear_history
 ```yaml
 service: ha_text_ai.clear_history
+data:
+  instance: sensor.ha_text_ai_gpt
 ```
 
 ### get_history
@@ -278,6 +284,7 @@ service: ha_text_ai.get_history
 data:
   limit: 5  # optional
   filter_model: "gpt-4o"  # optional
+  instance: sensor.ha_text_ai_gpt
 ```
 
 ### 🏷️ HA Text AI Sensor Naming Convention
@@ -400,7 +407,7 @@ automation:
 # Number of entries in current history file
 {{ state_attr('sensor.ha_text_ai_gpt', 'History size') }}          # 0  
 
-# Last few conversation entries (limited to 3 for performance)
+# Last few conversation entries (limited to 1 for performance)
 {{ state_attr('sensor.ha_text_ai_gpt', 'conversation_history') }}  # [...]
 ```
 

custom_components/ha_text_ai/const.py

@@ -6,6 +6,8 @@ Constants for the HA text AI integration.
 @github: https://github.com/smkrv/ha-text-ai
 @source: https://github.com/smkrv/ha-text-ai
 """
+import os
+import json 
 from typing import Final
 import voluptuous as vol
 from homeassistant.const import Platform, CONF_API_KEY, CONF_NAME
@@ -25,6 +27,22 @@ API_PROVIDERS: Final = [
     API_PROVIDER_ANTHROPIC
 ]
 
+# Read version from manifest.json
+MANIFEST_PATH = os.path.join(os.path.dirname(__file__), "manifest.json")
+try:
+    with open(MANIFEST_PATH) as manifest_file:
+        manifest = json.load(manifest_file)
+        VERSION = manifest.get("version", "unknown")
+except FileNotFoundError:
+    VERSION = "unknown"
+    _LOGGER.warning("manifest.json not found at %s", MANIFEST_PATH)
+except json.JSONDecodeError as err:
+    VERSION = "unknown"
+    _LOGGER.error("Error decoding JSON from manifest.json: %s", err)
+except Exception as err:
+    VERSION = "unknown"
+    _LOGGER.error("Error reading manifest.json: %s", err)
+
 # Default endpoints
 DEFAULT_OPENAI_ENDPOINT: Final = "https://api.openai.com/v1"
 DEFAULT_ANTHROPIC_ENDPOINT: Final = "https://api.anthropic.com"
@@ -56,6 +74,8 @@ DEFAULT_NAME: Final = "HA Text AI"
 DEFAULT_NAME_PREFIX = "ha_text_ai"
 DEFAULT_CONTEXT_MESSAGES: Final = 5
 
+TRUNCATION_INDICATOR = " ... "
+
 # Parameter constraints
 MIN_TEMPERATURE: Final = 0.0
 MAX_TEMPERATURE: Final = 2.0

custom_components/ha_text_ai/coordinator.py

@@ -41,6 +41,7 @@ from .const import (
     ABSOLUTE_MAX_HISTORY_SIZE,
     MAX_ATTRIBUTE_SIZE,
     MAX_HISTORY_FILE_SIZE,
+    TRUNCATION_INDICATOR,
 )
 
 _LOGGER = logging.getLogger(__name__)
@@ -647,15 +648,14 @@ class HATextAICoordinator(DataUpdateCoordinator):
 
     async def _async_update_data(self) -> Dict[str, Any]:
         """Update coordinator data with improved error handling and performance."""
-
         try:
             async with asyncio.Semaphore(1):
                 current_state = self._get_current_state()
 
-                limited_history = await self._get_limited_history()
+                # Get limited history with info
+                history_data = await self._get_limited_history()
 
                 metrics = await self._get_current_metrics()
-
                 if metrics is None:
                     metrics = {}
 
@@ -670,47 +670,68 @@ class HATextAICoordinator(DataUpdateCoordinator):
                     "uptime": self._calculate_uptime(),
                     "system_prompt": self._get_truncated_system_prompt(),
                     "history_size": len(self._conversation_history),
-                    "conversation_history": limited_history,
+                    "conversation_history": history_data["entries"],
+                    "history_info": history_data["info"],
                     "normalized_name": self.normalized_name,
                 }
 
                 await self._validate_update_data(data)
-
                 return data
 
-        except asyncio.CancelledError:
-            _LOGGER.warning("Update was cancelled")
-            raise
         except Exception as err:
             _LOGGER.error(f"Error updating data: {err}", exc_info=True)
             return self._get_safe_initial_state()
 
-    async def _get_limited_history(self) -> List[Dict[str, Any]]:
+    async def _get_limited_history(self) -> Dict[str, Any]:
-        """Get limited conversation history with size constraints."""
+        """Get limited conversation history showing only last Q&A."""
         limited_history = []
+
         if self._conversation_history:
-            for entry in self._conversation_history[-3:]:
+            last_entry = self._conversation_history[-1]
-                limited_entry = {
+            limited_entry = {
-                    "timestamp": entry["timestamp"],
+                "timestamp": last_entry["timestamp"],
-                    "question": self._truncate_text(entry["question"]),
+                "question": last_entry["question"][:4096] + (TRUNCATION_INDICATOR if len(last_entry["question"]) > 4096 else ""),
-                    "response": self._truncate_text(entry["response"]),
+                "response": last_entry["response"][:4096] + (TRUNCATION_INDICATOR if len(last_entry["response"]) > 4096 else ""),
-                }
+            }
-                limited_history.append(limited_entry)
+            limited_history.append(limited_entry)
-        return limited_history
+
+        history_info = {
+            "total_entries": len(self._conversation_history),
+            "displayed_entries": len(limited_history),
+            "full_history_available": True,
+            "history_path": self._history_file,
+        }
+
+        return {
+            "entries": limited_history,
+            "full_history": self._conversation_history,
+            "info": history_info
+        }
+
+    async def _get_sanitized_last_response(self) -> Dict[str, Any]:
+        """Get sanitized version of last response with truncation indicators."""
+        response = self.last_response.copy()
+
+        if "response" in response:
+            original_response = response["response"]
+            is_response_truncated = len(original_response) > 4096
+            response["response"] = original_response[:4096] + (TRUNCATION_INDICATOR if is_response_truncated else "")
+            response["is_response_truncated"] = is_response_truncated
+            response["full_response_length"] = len(original_response)
+
+        if "question" in response:
+            original_question = response["question"]
+            is_question_truncated = len(original_question) > 4096
+            response["question"] = original_question[:4096] + (TRUNCATION_INDICATOR if is_question_truncated else "")
+            response["is_question_truncated"] = is_question_truncated
+            response["full_question_length"] = len(original_question)
+
+        return response
 
     def _truncate_text(self, text: str, max_length: int = MAX_ATTRIBUTE_SIZE) -> str:
         """Safely truncate text to maximum length."""
         return text[:max_length] if text else ""
 
-    async def _get_sanitized_last_response(self) -> Dict[str, Any]:
-        """Get sanitized version of last response."""
-        response = self.last_response.copy()
-        if "response" in response:
-            response["response"] = self._truncate_text(response["response"])
-        if "question" in response:
-            response["question"] = self._truncate_text(response["question"])
-        return response
-
     def _calculate_uptime(self) -> float:
         """Calculate current uptime in seconds."""
         return (dt_util.utcnow() - self._start_time).total_seconds()

custom_components/ha_text_ai/manifest.json

@@ -23,6 +23,6 @@
   "single_config_entry": false,
   "ssdp": [],
   "usb": [],
-  "version": "2.0.8",
+  "version": "2.1.0",
   "zeroconf": []
 }

custom_components/ha_text_ai/sensor.py

@@ -68,6 +68,7 @@ from .const import (
     DEFAULT_NAME_PREFIX,
     CONF_MAX_HISTORY_SIZE,
     MAX_ATTRIBUTE_SIZE,
+    VERSION,
 )
 
 from .coordinator import HATextAICoordinator
@@ -154,7 +155,7 @@ class HATextAISensor(CoordinatorEntity, SensorEntity):
             name=self._attr_name,
             manufacturer="Community",
             model=f"{model} ({api_provider} provider)",
-            sw_version="1.0.0",
+            sw_version=VERSION, 
         )
 
         _LOGGER.debug(