mirror of
https://github.com/smkrv/ha-text-ai.git
synced 2026-07-21 22:54:00 +08:00
- Extended OptionsFlowHandler with two-step configuration flow - Step 1: Select provider (OpenAI, Anthropic, DeepSeek, Gemini) - Step 2: Configure API key, endpoint, model, and other settings - Auto-reload integration on options change - When switching providers, show appropriate default endpoint and model - Updated translations for all 8 languages
702 lines
30 KiB
Python
702 lines
30 KiB
Python
"""
|
|
Config flow for HA text AI integration.
|
|
|
|
@license: CC BY-NC-SA 4.0 International
|
|
@author: SMKRV
|
|
@github: https://github.com/smkrv/ha-text-ai
|
|
@source: https://github.com/smkrv/ha-text-ai
|
|
"""
|
|
import logging
|
|
from typing import Any, Dict, Optional
|
|
from datetime import datetime, timedelta
|
|
|
|
import voluptuous as vol
|
|
from homeassistant import config_entries
|
|
from homeassistant.const import CONF_API_KEY, CONF_NAME
|
|
from homeassistant.core import callback
|
|
from homeassistant.data_entry_flow import FlowResult
|
|
from homeassistant.helpers.aiohttp_client import async_get_clientsession
|
|
from homeassistant.helpers import selector
|
|
|
|
from .const import (
|
|
DOMAIN,
|
|
CONF_MODEL,
|
|
CONF_TEMPERATURE,
|
|
CONF_MAX_TOKENS,
|
|
CONF_API_ENDPOINT,
|
|
CONF_REQUEST_INTERVAL,
|
|
CONF_API_TIMEOUT,
|
|
CONF_API_PROVIDER,
|
|
CONF_CONTEXT_MESSAGES,
|
|
API_PROVIDER_OPENAI,
|
|
API_PROVIDER_ANTHROPIC,
|
|
API_PROVIDER_DEEPSEEK,
|
|
API_PROVIDER_GEMINI,
|
|
API_PROVIDERS,
|
|
DEFAULT_MODEL,
|
|
DEFAULT_DEEPSEEK_MODEL,
|
|
DEFAULT_GEMINI_MODEL,
|
|
DEFAULT_TEMPERATURE,
|
|
DEFAULT_MAX_TOKENS,
|
|
DEFAULT_REQUEST_INTERVAL,
|
|
DEFAULT_API_TIMEOUT,
|
|
DEFAULT_OPENAI_ENDPOINT,
|
|
DEFAULT_ANTHROPIC_ENDPOINT,
|
|
DEFAULT_DEEPSEEK_ENDPOINT,
|
|
DEFAULT_GEMINI_ENDPOINT,
|
|
DEFAULT_CONTEXT_MESSAGES,
|
|
MIN_TEMPERATURE,
|
|
MAX_TEMPERATURE,
|
|
MIN_MAX_TOKENS,
|
|
MAX_MAX_TOKENS,
|
|
MIN_REQUEST_INTERVAL,
|
|
MIN_API_TIMEOUT,
|
|
MAX_API_TIMEOUT,
|
|
DEFAULT_NAME_PREFIX,
|
|
DEFAULT_MAX_HISTORY,
|
|
CONF_MAX_HISTORY_SIZE,
|
|
)
|
|
|
|
_LOGGER = logging.getLogger(__name__)
|
|
|
|
|
|
def normalize_name(name: str) -> str:
|
|
"""Normalize name to conform to HA naming convention using underscores."""
|
|
normalized = ''.join(c if c.isalnum() or c == '_' else '_' for c in name)
|
|
normalized = '_'.join(filter(None, normalized.split('_')))
|
|
return normalized.lower()
|
|
|
|
|
|
class HATextAIConfigFlow(config_entries.ConfigFlow, domain=DOMAIN):
|
|
"""Handle a config flow for HA text AI."""
|
|
|
|
VERSION = 1
|
|
|
|
def __init__(self) -> None:
|
|
"""Initialize flow."""
|
|
self._errors = {}
|
|
self._data = {}
|
|
self._provider = None
|
|
|
|
async def async_step_user(self, user_input: Optional[Dict[str, Any]] = None) -> FlowResult:
|
|
"""Handle the initial step."""
|
|
if user_input is None:
|
|
return self.async_show_form(
|
|
step_id="user",
|
|
data_schema=vol.Schema({
|
|
vol.Required(CONF_API_PROVIDER): selector.SelectSelector(
|
|
selector.SelectSelectorConfig(
|
|
options=API_PROVIDERS,
|
|
translation_key="api_provider"
|
|
)
|
|
),
|
|
})
|
|
)
|
|
|
|
self._provider = user_input[CONF_API_PROVIDER]
|
|
return await self.async_step_provider()
|
|
|
|
async def async_step_provider(self, user_input: Optional[Dict[str, Any]] = None) -> FlowResult:
|
|
"""Handle provider configuration step."""
|
|
self._errors = {}
|
|
|
|
if user_input is None:
|
|
# Selecting an endpoint by provider
|
|
default_endpoint = {
|
|
API_PROVIDER_OPENAI: DEFAULT_OPENAI_ENDPOINT,
|
|
API_PROVIDER_ANTHROPIC: DEFAULT_ANTHROPIC_ENDPOINT,
|
|
API_PROVIDER_DEEPSEEK: DEFAULT_DEEPSEEK_ENDPOINT,
|
|
API_PROVIDER_GEMINI: DEFAULT_GEMINI_ENDPOINT,
|
|
}.get(self._provider, DEFAULT_OPENAI_ENDPOINT)
|
|
|
|
# Selecting the default model by provider
|
|
default_model = (
|
|
DEFAULT_DEEPSEEK_MODEL if self._provider == API_PROVIDER_DEEPSEEK else
|
|
DEFAULT_GEMINI_MODEL if self._provider == API_PROVIDER_GEMINI else
|
|
DEFAULT_MODEL
|
|
)
|
|
|
|
return self.async_show_form(
|
|
step_id="provider",
|
|
data_schema=vol.Schema({
|
|
vol.Required(CONF_NAME, default="my_assistant"): str,
|
|
vol.Required(CONF_API_KEY): str,
|
|
vol.Required(CONF_MODEL, default=default_model): str,
|
|
vol.Required(CONF_API_ENDPOINT, default=default_endpoint): str,
|
|
vol.Optional(CONF_TEMPERATURE, default=DEFAULT_TEMPERATURE): vol.All(
|
|
vol.Coerce(float),
|
|
vol.Range(min=MIN_TEMPERATURE, max=MAX_TEMPERATURE)
|
|
),
|
|
vol.Optional(CONF_MAX_TOKENS, default=DEFAULT_MAX_TOKENS): vol.All(
|
|
vol.Coerce(int),
|
|
vol.Range(min=MIN_MAX_TOKENS, max=MAX_MAX_TOKENS)
|
|
),
|
|
vol.Optional(CONF_REQUEST_INTERVAL, default=DEFAULT_REQUEST_INTERVAL): vol.All(
|
|
vol.Coerce(float),
|
|
vol.Range(min=MIN_REQUEST_INTERVAL)
|
|
),
|
|
vol.Optional(CONF_API_TIMEOUT, default=DEFAULT_API_TIMEOUT): vol.All(
|
|
vol.Coerce(int),
|
|
vol.Range(min=MIN_API_TIMEOUT, max=MAX_API_TIMEOUT)
|
|
),
|
|
vol.Optional(
|
|
CONF_CONTEXT_MESSAGES,
|
|
default=DEFAULT_CONTEXT_MESSAGES
|
|
): vol.All(
|
|
vol.Coerce(int),
|
|
vol.Range(min=1, max=20)
|
|
),
|
|
vol.Optional(
|
|
CONF_MAX_HISTORY_SIZE,
|
|
default=DEFAULT_MAX_HISTORY
|
|
): vol.All(
|
|
vol.Coerce(int),
|
|
vol.Range(min=1, max=100)
|
|
),
|
|
})
|
|
)
|
|
|
|
# Debug log to identify what's in the input
|
|
_LOGGER.debug(f"Provider step input data: {user_input}")
|
|
|
|
input_copy = user_input.copy()
|
|
|
|
# Check if CONF_NAME exists in input_copy and ensure it's not empty
|
|
if CONF_NAME not in input_copy or not input_copy[CONF_NAME]:
|
|
_LOGGER.warning(f"Missing name in configuration input: {input_copy}")
|
|
input_copy[CONF_NAME] = f"gemini_assistant_{datetime.now().strftime('%Y%m%d_%H%M%S')}"
|
|
_LOGGER.info(f"Auto-generated name: {input_copy[CONF_NAME]}")
|
|
|
|
# Ensure API key is present
|
|
if CONF_API_KEY not in input_copy or not input_copy[CONF_API_KEY]:
|
|
self._errors["base"] = "invalid_auth"
|
|
_LOGGER.error("API validation error: 'api_key'")
|
|
return self.async_show_form(
|
|
step_id="provider",
|
|
data_schema=vol.Schema({
|
|
vol.Required(CONF_NAME, default=input_copy.get(CONF_NAME, "my_assistant")): str,
|
|
vol.Required(CONF_API_KEY): str,
|
|
vol.Required(CONF_MODEL, default=input_copy.get(CONF_MODEL, DEFAULT_GEMINI_MODEL if self._provider == API_PROVIDER_GEMINI else DEFAULT_MODEL)): str,
|
|
vol.Required(CONF_API_ENDPOINT, default=input_copy.get(CONF_API_ENDPOINT, DEFAULT_GEMINI_ENDPOINT if self._provider == API_PROVIDER_GEMINI else DEFAULT_OPENAI_ENDPOINT)): str,
|
|
vol.Optional(CONF_TEMPERATURE, default=input_copy.get(CONF_TEMPERATURE, DEFAULT_TEMPERATURE)): vol.All(
|
|
vol.Coerce(float),
|
|
vol.Range(min=MIN_TEMPERATURE, max=MAX_TEMPERATURE)
|
|
),
|
|
vol.Optional(CONF_MAX_TOKENS, default=input_copy.get(CONF_MAX_TOKENS, DEFAULT_MAX_TOKENS)): vol.All(
|
|
vol.Coerce(int),
|
|
vol.Range(min=MIN_MAX_TOKENS, max=MAX_MAX_TOKENS)
|
|
),
|
|
vol.Optional(CONF_REQUEST_INTERVAL, default=input_copy.get(CONF_REQUEST_INTERVAL, DEFAULT_REQUEST_INTERVAL)): vol.All(
|
|
vol.Coerce(float),
|
|
vol.Range(min=MIN_REQUEST_INTERVAL)
|
|
),
|
|
vol.Optional(CONF_API_TIMEOUT, default=input_copy.get(CONF_API_TIMEOUT, DEFAULT_API_TIMEOUT)): vol.All(
|
|
vol.Coerce(int),
|
|
vol.Range(min=MIN_API_TIMEOUT, max=MAX_API_TIMEOUT)
|
|
),
|
|
vol.Optional(
|
|
CONF_CONTEXT_MESSAGES,
|
|
default=input_copy.get(CONF_CONTEXT_MESSAGES, DEFAULT_CONTEXT_MESSAGES)
|
|
): vol.All(
|
|
vol.Coerce(int),
|
|
vol.Range(min=1, max=20)
|
|
),
|
|
vol.Optional(
|
|
CONF_MAX_HISTORY_SIZE,
|
|
default=input_copy.get(CONF_MAX_HISTORY_SIZE, DEFAULT_MAX_HISTORY)
|
|
): vol.All(
|
|
vol.Coerce(int),
|
|
vol.Range(min=1, max=100)
|
|
),
|
|
}),
|
|
errors=self._errors
|
|
)
|
|
|
|
try:
|
|
# Validate and normalize the name
|
|
normalized_name = self._validate_and_normalize_name(input_copy[CONF_NAME])
|
|
input_copy[CONF_NAME] = normalized_name
|
|
except ValueError as e:
|
|
return self.async_show_form(
|
|
step_id="provider",
|
|
data_schema=vol.Schema({
|
|
vol.Required(CONF_NAME, default=input_copy.get(CONF_NAME, "my_assistant")): str,
|
|
vol.Required(CONF_API_KEY, default=input_copy.get(CONF_API_KEY, "")): str,
|
|
vol.Required(CONF_MODEL, default=input_copy.get(CONF_MODEL, DEFAULT_GEMINI_MODEL if self._provider == API_PROVIDER_GEMINI else DEFAULT_MODEL)): str,
|
|
vol.Required(CONF_API_ENDPOINT, default=input_copy.get(CONF_API_ENDPOINT, DEFAULT_GEMINI_ENDPOINT if self._provider == API_PROVIDER_GEMINI else DEFAULT_OPENAI_ENDPOINT)): str,
|
|
vol.Optional(CONF_TEMPERATURE, default=input_copy.get(CONF_TEMPERATURE, DEFAULT_TEMPERATURE)): vol.All(
|
|
vol.Coerce(float),
|
|
vol.Range(min=MIN_TEMPERATURE, max=MAX_TEMPERATURE)
|
|
),
|
|
vol.Optional(CONF_MAX_TOKENS, default=input_copy.get(CONF_MAX_TOKENS, DEFAULT_MAX_TOKENS)): vol.All(
|
|
vol.Coerce(int),
|
|
vol.Range(min=MIN_MAX_TOKENS, max=MAX_MAX_TOKENS)
|
|
),
|
|
vol.Optional(CONF_REQUEST_INTERVAL, default=input_copy.get(CONF_REQUEST_INTERVAL, DEFAULT_REQUEST_INTERVAL)): vol.All(
|
|
vol.Coerce(float),
|
|
vol.Range(min=MIN_REQUEST_INTERVAL)
|
|
),
|
|
vol.Optional(CONF_API_TIMEOUT, default=input_copy.get(CONF_API_TIMEOUT, DEFAULT_API_TIMEOUT)): vol.All(
|
|
vol.Coerce(int),
|
|
vol.Range(min=MIN_API_TIMEOUT, max=MAX_API_TIMEOUT)
|
|
),
|
|
vol.Optional(
|
|
CONF_CONTEXT_MESSAGES,
|
|
default=input_copy.get(CONF_CONTEXT_MESSAGES, DEFAULT_CONTEXT_MESSAGES)
|
|
): vol.All(
|
|
vol.Coerce(int),
|
|
vol.Range(min=1, max=20)
|
|
),
|
|
vol.Optional(
|
|
CONF_MAX_HISTORY_SIZE,
|
|
default=input_copy.get(CONF_MAX_HISTORY_SIZE, DEFAULT_MAX_HISTORY)
|
|
): vol.All(
|
|
vol.Coerce(int),
|
|
vol.Range(min=1, max=100)
|
|
),
|
|
}),
|
|
errors={"name": str(e)}
|
|
)
|
|
|
|
try:
|
|
# Special handling for Gemini API validation
|
|
if self._provider == API_PROVIDER_GEMINI:
|
|
# For Gemini, we just check if API key is present as there's no simple endpoint to validate
|
|
if not input_copy.get(CONF_API_KEY):
|
|
self._errors["base"] = "invalid_auth"
|
|
_LOGGER.error("API validation error: 'api_key'")
|
|
return self.async_show_form(
|
|
step_id="provider",
|
|
data_schema=vol.Schema({
|
|
vol.Required(CONF_NAME, default=input_copy.get(CONF_NAME, "my_assistant")): str,
|
|
vol.Required(CONF_API_KEY): str,
|
|
vol.Required(CONF_MODEL, default=input_copy.get(CONF_MODEL, DEFAULT_GEMINI_MODEL)): str,
|
|
vol.Required(CONF_API_ENDPOINT, default=input_copy.get(CONF_API_ENDPOINT, DEFAULT_GEMINI_ENDPOINT)): str,
|
|
# Other fields remain the same
|
|
}),
|
|
errors=self._errors
|
|
)
|
|
else:
|
|
# For other providers, validate API connection
|
|
if not await self._async_validate_api(input_copy):
|
|
return self.async_show_form(
|
|
step_id="provider",
|
|
data_schema=vol.Schema({
|
|
vol.Required(CONF_NAME, default=input_copy.get(CONF_NAME, "my_assistant")): str,
|
|
vol.Required(CONF_API_KEY, default=input_copy.get(CONF_API_KEY, "")): str,
|
|
vol.Required(CONF_MODEL, default=input_copy.get(CONF_MODEL, DEFAULT_MODEL)): str,
|
|
vol.Required(CONF_API_ENDPOINT, default=input_copy.get(CONF_API_ENDPOINT, DEFAULT_OPENAI_ENDPOINT)): str,
|
|
vol.Optional(CONF_TEMPERATURE, default=input_copy.get(CONF_TEMPERATURE, DEFAULT_TEMPERATURE)): vol.All(
|
|
vol.Coerce(float),
|
|
vol.Range(min=MIN_TEMPERATURE, max=MAX_TEMPERATURE)
|
|
),
|
|
vol.Optional(CONF_MAX_TOKENS, default=input_copy.get(CONF_MAX_TOKENS, DEFAULT_MAX_TOKENS)): vol.All(
|
|
vol.Coerce(int),
|
|
vol.Range(min=MIN_MAX_TOKENS, max=MAX_MAX_TOKENS)
|
|
),
|
|
vol.Optional(CONF_REQUEST_INTERVAL, default=input_copy.get(CONF_REQUEST_INTERVAL, DEFAULT_REQUEST_INTERVAL)): vol.All(
|
|
vol.Coerce(float),
|
|
vol.Range(min=MIN_REQUEST_INTERVAL)
|
|
),
|
|
vol.Optional(CONF_API_TIMEOUT, default=input_copy.get(CONF_API_TIMEOUT, DEFAULT_API_TIMEOUT)): vol.All(
|
|
vol.Coerce(int),
|
|
vol.Range(min=MIN_API_TIMEOUT, max=MAX_API_TIMEOUT)
|
|
),
|
|
vol.Optional(
|
|
CONF_CONTEXT_MESSAGES,
|
|
default=input_copy.get(CONF_CONTEXT_MESSAGES, DEFAULT_CONTEXT_MESSAGES)
|
|
): vol.All(
|
|
vol.Coerce(int),
|
|
vol.Range(min=1, max=20)
|
|
),
|
|
vol.Optional(
|
|
CONF_MAX_HISTORY_SIZE,
|
|
default=input_copy.get(CONF_MAX_HISTORY_SIZE, DEFAULT_MAX_HISTORY)
|
|
): vol.All(
|
|
vol.Coerce(int),
|
|
vol.Range(min=1, max=100)
|
|
),
|
|
}),
|
|
errors=self._errors
|
|
)
|
|
except Exception as e:
|
|
# Handle any unexpected exceptions during validation
|
|
_LOGGER.exception("Unexpected error during API validation")
|
|
return self.async_show_form(
|
|
step_id="provider",
|
|
data_schema=vol.Schema({
|
|
vol.Required(CONF_NAME, default=input_copy.get(CONF_NAME, "my_assistant")): str,
|
|
vol.Required(CONF_API_KEY, default=input_copy.get(CONF_API_KEY, "")): str,
|
|
vol.Required(CONF_MODEL, default=input_copy.get(CONF_MODEL, DEFAULT_GEMINI_MODEL if self._provider == API_PROVIDER_GEMINI else DEFAULT_MODEL)): str,
|
|
vol.Required(CONF_API_ENDPOINT, default=input_copy.get(CONF_API_ENDPOINT, DEFAULT_GEMINI_ENDPOINT if self._provider == API_PROVIDER_GEMINI else DEFAULT_OPENAI_ENDPOINT)): str,
|
|
# Other fields remain the same
|
|
}),
|
|
errors={"base": str(e)}
|
|
)
|
|
|
|
# All validation passed, create the entry
|
|
return await self._create_entry(input_copy)
|
|
|
|
def _validate_and_normalize_name(self, name: str) -> str:
|
|
"""
|
|
Validate and normalize name with detailed error handling.
|
|
|
|
Raises:
|
|
ValueError: If name is invalid
|
|
|
|
Returns:
|
|
Normalized name
|
|
"""
|
|
if not name:
|
|
raise ValueError("empty")
|
|
|
|
name = name.strip()
|
|
normalized = ''.join(
|
|
c if c.isalnum() or c in ' _' else '_' # Only allow underscores
|
|
for c in name
|
|
)
|
|
|
|
normalized = normalized.replace(' ', '_').lower()
|
|
|
|
for entry in self._async_current_entries():
|
|
if entry.data.get(CONF_NAME, "") == normalized:
|
|
raise ValueError("name_exists")
|
|
|
|
normalized = normalized[:50]
|
|
|
|
if not normalized:
|
|
raise ValueError("empty")
|
|
|
|
return normalized
|
|
|
|
async def _async_validate_api(self, user_input: Dict[str, Any]) -> bool:
|
|
"""Validate API connection."""
|
|
try:
|
|
if CONF_API_KEY not in user_input:
|
|
_LOGGER.error("API validation error: 'api_key'")
|
|
self._errors["base"] = "invalid_auth"
|
|
return False
|
|
|
|
session = async_get_clientsession(self.hass)
|
|
headers = self._get_api_headers(user_input)
|
|
endpoint = user_input[CONF_API_ENDPOINT].rstrip('/')
|
|
|
|
if self._provider == API_PROVIDER_GEMINI:
|
|
if not user_input[CONF_API_KEY]:
|
|
self._errors["base"] = "invalid_auth"
|
|
return False
|
|
return True
|
|
else:
|
|
check_url = (
|
|
f"{endpoint}/v1/models" if self._provider == API_PROVIDER_ANTHROPIC
|
|
else f"{endpoint}/models"
|
|
)
|
|
|
|
async with session.get(check_url, headers=headers) as response:
|
|
if response.status == 401:
|
|
self._errors["base"] = "invalid_auth"
|
|
return False
|
|
elif response.status not in [200, 404]:
|
|
self._errors["base"] = "cannot_connect"
|
|
return False
|
|
return True
|
|
|
|
except Exception as err:
|
|
_LOGGER.error("API validation error: %s", str(err))
|
|
self._errors["base"] = "cannot_connect"
|
|
return False
|
|
|
|
def _get_api_headers(self, user_input: Dict[str, Any]) -> Dict[str, str]:
|
|
"""Get API headers based on provider."""
|
|
if CONF_API_KEY not in user_input:
|
|
return {"Content-Type": "application/json"}
|
|
|
|
api_key = user_input[CONF_API_KEY]
|
|
|
|
if self._provider == API_PROVIDER_ANTHROPIC:
|
|
return {
|
|
"x-api-key": api_key,
|
|
"anthropic-version": "2023-06-01",
|
|
"Content-Type": "application/json"
|
|
}
|
|
elif self._provider == API_PROVIDER_GEMINI:
|
|
return {
|
|
"Authorization": f"Bearer {api_key}",
|
|
"Content-Type": "application/json"
|
|
}
|
|
return {
|
|
"Authorization": f"Bearer {api_key}",
|
|
"Content-Type": "application/json"
|
|
}
|
|
|
|
async def _create_entry(self, user_input: Dict[str, Any]) -> FlowResult:
|
|
"""Create the config entry with comprehensive data preservation."""
|
|
instance_name = user_input[CONF_NAME]
|
|
normalized_name = normalize_name(instance_name)
|
|
|
|
unique_id = f"{DOMAIN}_{normalized_name}_{self._provider}".lower()
|
|
|
|
default_model = (
|
|
DEFAULT_DEEPSEEK_MODEL if self._provider == API_PROVIDER_DEEPSEEK else
|
|
DEFAULT_GEMINI_MODEL if self._provider == API_PROVIDER_GEMINI else
|
|
DEFAULT_MODEL
|
|
)
|
|
|
|
entry_data = {
|
|
CONF_API_PROVIDER: self._provider,
|
|
CONF_NAME: instance_name,
|
|
"normalized_name": normalized_name,
|
|
CONF_API_KEY: user_input.get(CONF_API_KEY),
|
|
CONF_API_ENDPOINT: user_input.get(CONF_API_ENDPOINT),
|
|
"unique_id": unique_id,
|
|
CONF_MODEL: user_input.get(CONF_MODEL, default_model),
|
|
CONF_TEMPERATURE: user_input.get(CONF_TEMPERATURE, DEFAULT_TEMPERATURE),
|
|
CONF_MAX_TOKENS: user_input.get(CONF_MAX_TOKENS, DEFAULT_MAX_TOKENS),
|
|
CONF_REQUEST_INTERVAL: user_input.get(CONF_REQUEST_INTERVAL, DEFAULT_REQUEST_INTERVAL),
|
|
CONF_API_TIMEOUT: user_input.get(CONF_API_TIMEOUT, DEFAULT_API_TIMEOUT),
|
|
CONF_CONTEXT_MESSAGES: user_input.get(CONF_CONTEXT_MESSAGES, DEFAULT_CONTEXT_MESSAGES),
|
|
CONF_MAX_HISTORY_SIZE: user_input.get(CONF_MAX_HISTORY_SIZE, DEFAULT_MAX_HISTORY),
|
|
}
|
|
|
|
for key, value in user_input.items():
|
|
if key not in entry_data:
|
|
entry_data[key] = value
|
|
|
|
_LOGGER.debug(f"Creating config entry with data: {entry_data}")
|
|
|
|
return self.async_create_entry(
|
|
title=instance_name,
|
|
data=entry_data
|
|
)
|
|
|
|
@staticmethod
|
|
@callback
|
|
def async_get_options_flow(config_entry: config_entries.ConfigEntry) -> config_entries.OptionsFlow:
|
|
"""Get the options flow for this handler."""
|
|
return OptionsFlowHandler()
|
|
|
|
|
|
class OptionsFlowHandler(config_entries.OptionsFlow):
|
|
"""Handle options flow."""
|
|
|
|
def __init__(self) -> None:
|
|
"""Initialize options flow."""
|
|
self._errors = {}
|
|
self._selected_provider = None
|
|
|
|
def _get_default_endpoint(self, provider: str) -> str:
|
|
"""Get default endpoint for provider."""
|
|
return {
|
|
API_PROVIDER_OPENAI: DEFAULT_OPENAI_ENDPOINT,
|
|
API_PROVIDER_ANTHROPIC: DEFAULT_ANTHROPIC_ENDPOINT,
|
|
API_PROVIDER_DEEPSEEK: DEFAULT_DEEPSEEK_ENDPOINT,
|
|
API_PROVIDER_GEMINI: DEFAULT_GEMINI_ENDPOINT,
|
|
}.get(provider, DEFAULT_OPENAI_ENDPOINT)
|
|
|
|
def _get_default_model(self, provider: str) -> str:
|
|
"""Get default model for provider."""
|
|
return (
|
|
DEFAULT_DEEPSEEK_MODEL if provider == API_PROVIDER_DEEPSEEK else
|
|
DEFAULT_GEMINI_MODEL if provider == API_PROVIDER_GEMINI else
|
|
DEFAULT_MODEL
|
|
)
|
|
|
|
def _get_api_headers(self, api_key: str, provider: str) -> Dict[str, str]:
|
|
"""Get API headers based on provider."""
|
|
if provider == API_PROVIDER_ANTHROPIC:
|
|
return {
|
|
"x-api-key": api_key,
|
|
"anthropic-version": "2023-06-01",
|
|
"Content-Type": "application/json"
|
|
}
|
|
return {
|
|
"Authorization": f"Bearer {api_key}",
|
|
"Content-Type": "application/json"
|
|
}
|
|
|
|
async def _async_validate_api(self, provider: str, api_key: str, endpoint: str) -> bool:
|
|
"""Validate API connection."""
|
|
try:
|
|
if not api_key:
|
|
self._errors["base"] = "invalid_auth"
|
|
return False
|
|
|
|
# For Gemini, just check if API key is present
|
|
if provider == API_PROVIDER_GEMINI:
|
|
return True
|
|
|
|
session = async_get_clientsession(self.hass)
|
|
headers = self._get_api_headers(api_key, provider)
|
|
endpoint = endpoint.rstrip('/')
|
|
|
|
check_url = (
|
|
f"{endpoint}/v1/models" if provider == API_PROVIDER_ANTHROPIC
|
|
else f"{endpoint}/models"
|
|
)
|
|
|
|
async with session.get(check_url, headers=headers) as response:
|
|
if response.status == 401:
|
|
self._errors["base"] = "invalid_auth"
|
|
return False
|
|
elif response.status not in [200, 404]:
|
|
self._errors["base"] = "cannot_connect"
|
|
return False
|
|
return True
|
|
|
|
except Exception as err:
|
|
_LOGGER.error("API validation error: %s", str(err))
|
|
self._errors["base"] = "cannot_connect"
|
|
return False
|
|
|
|
async def async_step_init(self, user_input: Optional[Dict[str, Any]] = None) -> FlowResult:
|
|
"""Handle provider selection step."""
|
|
current_data = {**self.config_entry.data, **self.config_entry.options}
|
|
current_provider = current_data.get(CONF_API_PROVIDER, API_PROVIDER_OPENAI)
|
|
|
|
if user_input is not None:
|
|
self._selected_provider = user_input.get(CONF_API_PROVIDER, current_provider)
|
|
return await self.async_step_settings()
|
|
|
|
return self.async_show_form(
|
|
step_id="init",
|
|
data_schema=vol.Schema({
|
|
vol.Required(
|
|
CONF_API_PROVIDER,
|
|
default=current_provider
|
|
): selector.SelectSelector(
|
|
selector.SelectSelectorConfig(
|
|
options=API_PROVIDERS,
|
|
translation_key="api_provider"
|
|
)
|
|
),
|
|
}),
|
|
description_placeholders={
|
|
"current_provider": current_provider
|
|
}
|
|
)
|
|
|
|
async def async_step_settings(self, user_input: Optional[Dict[str, Any]] = None) -> FlowResult:
|
|
"""Handle settings configuration step."""
|
|
self._errors = {}
|
|
current_data = {**self.config_entry.data, **self.config_entry.options}
|
|
provider = self._selected_provider or current_data.get(CONF_API_PROVIDER, API_PROVIDER_OPENAI)
|
|
|
|
# Determine if provider changed to show appropriate defaults
|
|
provider_changed = provider != current_data.get(CONF_API_PROVIDER)
|
|
|
|
# Use new defaults if provider changed, otherwise use current values
|
|
if provider_changed:
|
|
default_endpoint = self._get_default_endpoint(provider)
|
|
default_model = self._get_default_model(provider)
|
|
else:
|
|
default_endpoint = current_data.get(CONF_API_ENDPOINT, self._get_default_endpoint(provider))
|
|
default_model = current_data.get(CONF_MODEL, self._get_default_model(provider))
|
|
|
|
if user_input is not None:
|
|
# Validate API connection
|
|
api_key = user_input.get(CONF_API_KEY, current_data.get(CONF_API_KEY, ""))
|
|
endpoint = user_input.get(CONF_API_ENDPOINT, default_endpoint)
|
|
|
|
if await self._async_validate_api(provider, api_key, endpoint):
|
|
# Merge with provider selection
|
|
final_data = {
|
|
CONF_API_PROVIDER: provider,
|
|
**user_input
|
|
}
|
|
return self.async_create_entry(title="", data=final_data)
|
|
|
|
# Show form again with errors
|
|
return self.async_show_form(
|
|
step_id="settings",
|
|
data_schema=self._get_settings_schema(
|
|
provider=provider,
|
|
current_data=current_data,
|
|
user_input=user_input,
|
|
default_endpoint=default_endpoint,
|
|
default_model=default_model,
|
|
),
|
|
errors=self._errors
|
|
)
|
|
|
|
return self.async_show_form(
|
|
step_id="settings",
|
|
data_schema=self._get_settings_schema(
|
|
provider=provider,
|
|
current_data=current_data,
|
|
user_input=None,
|
|
default_endpoint=default_endpoint,
|
|
default_model=default_model,
|
|
),
|
|
description_placeholders={
|
|
"provider": provider
|
|
}
|
|
)
|
|
|
|
def _get_settings_schema(
|
|
self,
|
|
provider: str,
|
|
current_data: Dict[str, Any],
|
|
user_input: Optional[Dict[str, Any]],
|
|
default_endpoint: str,
|
|
default_model: str,
|
|
) -> vol.Schema:
|
|
"""Build settings schema."""
|
|
data = user_input or current_data
|
|
|
|
return vol.Schema({
|
|
vol.Required(
|
|
CONF_API_KEY,
|
|
default=data.get(CONF_API_KEY, "")
|
|
): str,
|
|
vol.Required(
|
|
CONF_API_ENDPOINT,
|
|
default=data.get(CONF_API_ENDPOINT, default_endpoint)
|
|
): str,
|
|
vol.Required(
|
|
CONF_MODEL,
|
|
default=data.get(CONF_MODEL, default_model)
|
|
): str,
|
|
vol.Optional(
|
|
CONF_TEMPERATURE,
|
|
default=data.get(CONF_TEMPERATURE, DEFAULT_TEMPERATURE)
|
|
): vol.All(
|
|
vol.Coerce(float),
|
|
vol.Range(min=MIN_TEMPERATURE, max=MAX_TEMPERATURE)
|
|
),
|
|
vol.Optional(
|
|
CONF_MAX_TOKENS,
|
|
default=data.get(CONF_MAX_TOKENS, DEFAULT_MAX_TOKENS)
|
|
): vol.All(
|
|
vol.Coerce(int),
|
|
vol.Range(min=MIN_MAX_TOKENS, max=MAX_MAX_TOKENS)
|
|
),
|
|
vol.Optional(
|
|
CONF_REQUEST_INTERVAL,
|
|
default=data.get(CONF_REQUEST_INTERVAL, DEFAULT_REQUEST_INTERVAL)
|
|
): vol.All(
|
|
vol.Coerce(float),
|
|
vol.Range(min=MIN_REQUEST_INTERVAL)
|
|
),
|
|
vol.Optional(
|
|
CONF_API_TIMEOUT,
|
|
default=data.get(CONF_API_TIMEOUT, DEFAULT_API_TIMEOUT)
|
|
): vol.All(
|
|
vol.Coerce(int),
|
|
vol.Range(min=MIN_API_TIMEOUT, max=MAX_API_TIMEOUT)
|
|
),
|
|
vol.Optional(
|
|
CONF_CONTEXT_MESSAGES,
|
|
default=data.get(CONF_CONTEXT_MESSAGES, DEFAULT_CONTEXT_MESSAGES)
|
|
): vol.All(
|
|
vol.Coerce(int),
|
|
vol.Range(min=1, max=20)
|
|
),
|
|
vol.Optional(
|
|
CONF_MAX_HISTORY_SIZE,
|
|
default=data.get(CONF_MAX_HISTORY_SIZE, DEFAULT_MAX_HISTORY)
|
|
): vol.All(
|
|
vol.Coerce(int),
|
|
vol.Range(min=1, max=100)
|
|
),
|
|
})
|