Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
17 changes: 17 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,23 @@

All notable changes to this project are documented here. This project follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/) conventions and [Semantic Versioning](https://semver.org/spec/v2.0.0.html).

## 1.3.0

Community contribution plus a floor reset: 1.3.0 is the first release that requires Home Assistant 2026.11.

### Added

- **`minimal` reasoning effort for OpenAI-compatible providers** — the `reasoning_effort` selector gains a `minimal` option (PR #9 by @AimanFarooq, closes #7). Reasoning models such as OpenAI's gpt-5 family accept `reasoning_effort=minimal`, which roughly halves first-text latency for short voice-assistant answers compared to `low`. The provider forwards any value other than `none` verbatim, so the change is the selector option, its label, and a regression test pinning the forwarding behavior.

### Changed

- **Home Assistant floor raised to 2026.11** — the `homeassistant: "2026.11.0"` key in `hacs.json` is now the project's supported floor rather than a temporary gate. The reason is structural: the manifest admits the anthropic 2.x line (`>=0.108.0,<3`) to stay compatible with HA 2026.11's core pin (`anthropic==2.3.0`), and the 2.x SDK pairs with httpx2, a pairing that only exists in 2026.11+. One manifest cannot serve both generations — capping below 2.x re-breaks hassfest on 2026.11, admitting 2.x breaks 2026.10 — so the floor is how the project draws that line. Clients below the floor see the repository as pending in HACS and the built-in Marketplace: no update is offered, existing installs run untouched, and the update surfaces within roughly six hours of a client reaching 2026.11. README requirements, badge, and troubleshooting now state 2026.11 (the troubleshooting entry also corrects a stale `anthropic` pin range).

### Validation

- Full suite on the pinned test tree (HA 2025.8.1, anthropic 0.125.0 — the test tree deliberately stays on older pins; code-level compatibility is verified there while hassfest validates the manifest against core): **134 passed, 2 skipped** — the 133/2 baseline plus the new forwarding test
- Hassfest and Tests green on PR #9 (merged as `9193b43`)

## 1.2.5

Compatibility fix for Home Assistant 2026.11's move to the anthropic SDK 2.x line.
Expand Down
8 changes: 4 additions & 4 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
# Configurable LLM for Home Assistant

[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![Home Assistant](https://img.shields.io/badge/Home_Assistant-2025.8%2B-blue.svg)](https://www.home-assistant.io/)
[![Home Assistant](https://img.shields.io/badge/Home_Assistant-2026.11%2B-blue.svg)](https://www.home-assistant.io/)
[![HACS Custom](https://img.shields.io/badge/HACS-Custom-orange.svg)](https://hacs.xyz/)

A Home Assistant integration that adds a conversation agent and AI task entity backed by any Anthropic- or OpenAI-compatible API endpoint. Based on the official Home Assistant Anthropic integration, extended with a provider-pluggable architecture and configurable base URLs.
Expand All @@ -23,7 +23,7 @@ If you're using the official Anthropic or OpenAI APIs directly, you should use H

### Requirements

- Home Assistant **2025.8** or newer
- Home Assistant **2026.11** or newer
- An API key for an Anthropic- or OpenAI-compatible service

### Via HACS (recommended)
Expand Down Expand Up @@ -203,8 +203,8 @@ Restart Home Assistant.

Check the Home Assistant log (`Settings → System → Logs`). The most common causes:

- **HA version too old** — this integration requires HA 2025.8 or newer because it uses AI task entities and config subentries
- **SDK install failed** — the integration requires `anthropic>=0.108.0,<0.109` and `openai>=2.45.0`; pip needs network access on first load
- **HA version too old** — this integration requires HA 2026.11 or newer because it uses AI task entities, config subentries, and the anthropic 2.x SDK line (HACS and the built-in Marketplace show the repository as pending below that version)
- **SDK install failed** — the integration requires `anthropic>=0.108.0,<3` and `openai>=2.45.0`; pip needs network access on first load

### Authentication fails

Expand Down
2 changes: 1 addition & 1 deletion custom_components/configurable_llm/manifest.json
Original file line number Diff line number Diff line change
Expand Up @@ -21,5 +21,5 @@
"openai>=2.45.0",
"voluptuous-openapi>=0.1.0,<0.5"
],
"version": "1.2.5"
"version": "1.3.0"
}
Loading