Bump actions/checkout from 4 to 6

.github/CODEOWNERS

@@ -0,0 +1 @@
+* @gritaro

.github/dependabot.yaml

@@ -0,0 +1,17 @@
+# To get started with Dependabot version updates, you'll need to specify which
+# package ecosystems to update and where the package manifests are located.
+# Please see the documentation for all configuration options:
+# https://docs.github.com/github/administering-a-repository/configuration-options-for-dependency-updates
+
+version: 2
+updates:
+- package-ecosystem: "pip"
+  directory: "/"
+  schedule:
+    interval: "daily"
+
+- package-ecosystem: "github-actions"
+  directory: "/"
+  schedule:
+    # Check for updates to GitHub Actions every weekday
+    interval: "daily"

.github/settings.yml

@@ -0,0 +1,36 @@
+# These settings are synced to GitHub by https://probot.github.io/apps/settings/
+
+repository:
+  name: ha-smartchain
+  description: "SmartChain — multi-provider LLM conversation agent for Home Assistant (GigaChat, YandexGPT, OpenAI) with tool calling and streaming"
+  homepage: https://github.com/gritaro/ha-smartchain
+  topics: homeassistant, hacs-integration, voice-assistant, langchain, gigachat, yandexgpt, openai, llm, smart-home, ai-agent
+  private: false
+  has_issues: true
+  has_projects: false
+  has_wiki: false
+  default_branch: main
+  allow_squash_merge: true
+  use_squash_pr_title_as_default: true
+  allow_merge_commit: false
+  allow_rebase_merge: true
+  delete_branch_on_merge: true
+  enable_vulnerability_alerts: true
+
+labels:
+- name: "Feature Request"
+  color: "00ffbb"
+- name: "Bug"
+  color: "e30000"
+- name: "Wont Fix"
+  color: "ffffff"
+- name: "Enhancement"
+  color: "48ff00"
+- name: "Documentation"
+  color: "0077ff"
+- name: "Help needed"
+  color: "fbca04"
+- name: "dependencies"
+  color: "000000"
+- name: "github_actions"
+  color: "000000"

.github/workflows/cron.yaml

@@ -0,0 +1,21 @@
+name: Cron HACS actions
+
+on:
+  schedule:
+  - cron: "0 0 * * *"
+
+jobs:
+  validate:
+    runs-on: "ubuntu-latest"
+    name: Validate
+    steps:
+    - uses: "actions/checkout@v6"
+
+    - name: HACS validation
+      uses: "hacs/action@main"
+      with:
+        category: "integration"
+        ignore: brands
+
+    - name: Hassfest validation
+      uses: "home-assistant/actions/hassfest@master"

.github/workflows/pull.yml

@@ -0,0 +1,40 @@
+name: Pull actions
+
+on:
+  pull_request:
+
+env:
+  PYTHON_VERSION: "3.12"
+
+jobs:
+  validate:
+    runs-on: "ubuntu-latest"
+    name: Validate
+    steps:
+    - uses: "actions/checkout@v6"
+
+    - name: HACS validation
+      uses: "hacs/action@main"
+      with:
+        category: "integration"
+
+    - name: Hassfest validation
+      uses: "home-assistant/actions/hassfest@master"
+
+  lint:
+    runs-on: "ubuntu-latest"
+    name: Lint with ruff
+    steps:
+    - uses: "actions/checkout@v6"
+    - uses: "astral-sh/setup-uv@v5"
+    - run: uv run ruff check .
+    - run: uv run ruff format --check .
+
+  test:
+    runs-on: "ubuntu-latest"
+    name: Run tests
+    steps:
+    - uses: "actions/checkout@v6"
+    - uses: "astral-sh/setup-uv@v5"
+    - run: uv sync
+    - run: uv run pytest tests/ -v

.github/workflows/push.yml

@@ -0,0 +1,44 @@
+name: Push actions
+
+on:
+  push:
+    branches:
+    - main
+    - rc-*
+
+env:
+  PYTHON_VERSION: "3.12"
+
+jobs:
+  validate:
+    runs-on: "ubuntu-latest"
+    name: Validate
+    steps:
+    - uses: "actions/checkout@v6"
+
+    - name: HACS validation
+      uses: "hacs/action@main"
+      with:
+        category: "integration"
+        ignore: brands
+
+    - name: Hassfest validation
+      uses: "home-assistant/actions/hassfest@master"
+
+  lint:
+    runs-on: "ubuntu-latest"
+    name: Lint with ruff
+    steps:
+    - uses: "actions/checkout@v6"
+    - uses: "astral-sh/setup-uv@v5"
+    - run: uv run ruff check .
+    - run: uv run ruff format --check .
+
+  test:
+    runs-on: "ubuntu-latest"
+    name: Run tests
+    steps:
+    - uses: "actions/checkout@v6"
+    - uses: "astral-sh/setup-uv@v5"
+    - run: uv sync
+    - run: uv run pytest tests/ -v

.gitignore

@@ -0,0 +1,13 @@
+__pycache__
+.idea
+/shelf/
+/workspace.xml
+/httpRequests/
+/dataSources/
+/dataSources.local.xml
+*.iws
+*.iml
+*.ipr
+/.mcp.json
+/.serena/
+.pytest_cache

.pre-commit-config.yaml

@@ -0,0 +1,6 @@
+repos:
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.9.7
+    hooks:
+      - id: ruff
+      - id: ruff-format

CHANGELOG.md

@@ -0,0 +1,75 @@
+# Changelog
+
+All notable changes to this project are documented in this file.
+
+Format based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+project follows [Semantic Versioning](https://semver.org/).
+
+## [0.7.0] - 2026-03-10
+
+### Changed
+- **Project renamed: GigaChain -> SmartChain** — reflects multi-provider nature (not GigaChat-only)
+- Domain: `gigachain` -> `smartchain`
+- Entity classes: `GigaChainConversationEntity` -> `SmartChainConversationEntity`
+- New GitHub repository: `ha-smartchain`
+- HACS name: SmartChain
+- Version bumped to 0.7.0
+
+### Added
+- **AI Task entity** — `SmartChainAITaskEntity` implements `ai_task.AITaskEntity` with `_async_generate_data()` for automation-driven text generation via `ai_task.generate_data` service
+- Structured output support in AI Task (JSON parsing with `task.structure`)
+- Tool calling support in AI Task (reuses conversation entity's LangChain integration)
+
+## [0.6.0] - 2026-03-10
+
+### Added
+- **Assist API for device control** — integration with HA LLM API (`async_provide_llm_data`) allows LLM to call Home Assistant services (turn on/off lights, locks, etc.)
+- `llm_hass_api` option in Options Flow — select HA API for LLM (Assist, custom APIs)
+- HA `llm.Tool` (voluptuous schema) -> LangChain tools conversion via `voluptuous_openapi` + `client.bind_tools()`
+- Tool calling loop with `MAX_TOOL_ITERATIONS = 10`
+- `tool_calls` in `AIMessageChunk` -> HA `ToolInput` in stream deltas
+- `ToolResultContent` <-> LangChain `ToolMessage` conversion in `_chatlog_to_langchain()`
+
+### Changed
+- `_async_handle_message` — uses `async_provide_llm_data` when LLM API configured, manual prompt otherwise
+- Options Flow: `common_config_option_schema` takes `hass` to list available LLM APIs
+
+## [0.5.0] - 2026-03-10
+
+### Added
+- **Streaming responses** — `_attr_supports_streaming = True`, responses streamed via `ChatLog.async_add_delta_content_stream()`
+- Async generator `_async_langchain_stream()` for `AIMessageChunk` -> HA delta dicts
+
+### Changed
+- `client.invoke()` via `async_add_executor_job` replaced with `client.astream()` (async, no executor)
+
+## [0.4.0] - 2026-03-10
+
+### Changed
+- **ChatLog for history** — removed custom `OrderedDict`, uses native HA `ChatLog`
+- **Migration to langchain-gigachat/langchain-openai** — proper package imports
+
+## [0.3.0] - 2026-03-10
+
+### Added
+- **Migration to ConversationEntity** — entity-based conversation agent with `_async_handle_message(user_input, chat_log)`
+
+## [0.2.0] - 2026-03-10
+
+### Fixed
+- Blocking LLM calls, deprecated LangChain API, memory leaks, model defaults
+
+### Removed
+- Anyscale support completely removed
+
+## [0.1.8] - 2024-12-01
+
+### Fixed
+- Compatibility with Home Assistant 2024.12.1+
+
+## [0.1.1] - 2024-03-01
+
+### Added
+- Initial release with GigaChat, YandexGPT support
+- Config Flow and Options Flow
+- Chat history and Jinja2 system prompts

CLAUDE.md

@@ -0,0 +1,57 @@
+# SmartChain — Project Rules
+
+## Project Overview
+SmartChain is a Home Assistant custom integration providing a multi-provider LLM conversation agent via LangChain.
+
+- **Domain**: `smartchain`
+- **HA Platform**: `Platform.CONVERSATION` (+ `Platform.AI_TASK` planned)
+- **Supported LLM providers**: GigaChat, YandexGPT, OpenAI
+- **Planned providers**: Ollama, DeepSeek, Anthropic
+- **GitHub**: https://github.com/dzerik/ha-smartchain
+
+## Architecture
+
+### Core Files
+- `custom_components/smartchain/__init__.py` — entry setup, client creation
+- `custom_components/smartchain/conversation.py` — `SmartChainConversationEntity` (streaming, tool calling)
+- `custom_components/smartchain/ai_task.py` — `SmartChainAITaskEntity` (data generation)
+- `custom_components/smartchain/config_flow.py` — Config Flow + Options Flow
+- `custom_components/smartchain/client_util.py` — LLM client factory (`get_client`, `validate_client`)
+- `custom_components/smartchain/const.py` — all constants, prompts, model lists
+
+### Key Patterns
+- **Streaming**: `client.astream()` -> `_async_langchain_stream()` -> `chat_log.async_add_delta_content_stream()`
+- **Tool calling**: HA `llm.Tool` -> `_ha_tool_to_dict()` -> `client.bind_tools()` -> loop until no `unresponded_tool_results`
+- **ChatLog conversion**: `_chatlog_to_langchain()` converts HA ChatLog content to LangChain message list
+- **System prompt**: With Assist API — `async_provide_llm_data()`, without — manual Jinja2 template + `DEFAULT_DEVICES_PROMPT`
+
+### Tests
+- `tests/test_config_flow.py` — 11 config flow tests
+- `tests/test_init.py` — 19 conversation entity tests
+- `tests/test_setup.py` — 4 setup/unload tests
+- Run: `python3 -m pytest tests/ -v`
+
+## Development Rules
+
+### Naming
+- Entity classes: `SmartChain*Entity` (e.g., `SmartChainConversationEntity`)
+- Imports: `from custom_components.smartchain.X import Y`
+- Domain constant: `DOMAIN = "smartchain"`
+
+### Testing
+- Always run tests before committing: `python3 -m pytest tests/ -v`
+- All tests must pass
+- Mock LLM clients with `MagicMock` + `astream` side_effect
+- Use `_make_chat_log()` helper for mock ChatLog with streaming support
+
+### Dependencies
+- `langchain-gigachat>=0.3.0` — GigaChat provider
+- `langchain-openai>=0.3.0` — OpenAI provider
+- `langchain-community>=0.4.0` — YandexGPT and others
+- `home-assistant-intents` — language support
+- `yandexcloud==0.295.0` — Yandex Cloud SDK
+
+### Version Policy
+- Manifest version in `custom_components/smartchain/manifest.json`
+- Follow semver: PATCH for fixes, MINOR for features, MAJOR for breaking changes
+- Current: 0.7.0

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 gritaro
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.