@camstack/addon-import-alexa 0.2.153 → 0.2.155

package/CHANGELOG.md

@@ -7,6 +7,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.2.155] - 2026-10-27
+
 ### Changed
 
 - Echo speech signs in as the import broker (its refresh token) instead of a
@@ -15,7 +17,3 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
   single broker, or is dropped with a named state when there are none or several.
 - The Alexa target form picks the Echo from the account's device list.
 - The Alexa kind serves the Alexa brand mark as its icon.
-
-### Added
-
-- Package README and changelog, included in the published files list.

package/README.md

@@ -1,18 +1,40 @@
-# @camstack/addon-import-alexa
+# Alexa
 
-Alexa device-import provider for CamStack — imports the smart-home devices in a user's Alexa account via the unofficial alexa-remote2 cookie/token client (the inverse of the Alexa exporter)
+Alexa device-import provider for CamStack — imports the smart-home devices in a user's Alexa account via the unofficial alexa-remote2 cookie/token client (the inverse of the Alexa exporter).
 
-## What it does
+<!-- readme:generated:start (derived from the manifest; edit outside this block) -->
 
-- **Alexa Import** (`import-alexa`): Import smart-home devices from an Amazon Alexa account (unofficial cookie/token client; poll-based state sync). Maps Alexa capability interfaces onto typed CamStack device caps.
-  - Node placement: `any-node`.
-  - Capabilities: `device-provider`, `broker`, `device-adoption`, `addon-routes`.
+Package `@camstack/addon-import-alexa` on npm.
 
-## Settings
+## What it provides
 
-Settings this addon exposes are edited from System → Addons → this addon → Settings when they apply to the whole cluster, and from the device page when they belong to one device. A password field is stored in the keychain.
+- **Alexa** (`import-alexa`): Import smart-home devices from an Amazon Alexa account (unofficial cookie/token client; poll-based state sync). The same account can speak a notification aloud on Echo devices. Category: providers.
+  - Capabilities: `device-provider`, `broker`, `device-adoption`, `addon-routes`, `notification-output`, `addon-pages-source`.
+
+## Configuration
+
+Edit these from System, Addons, this addon, Settings (a device's own settings are on its device page). A password field is stored in the keychain.
+
+**Addon settings**
+
+- Amazon Alexa account: Accounts are managed separately
+- Interactive login (proxy): Login proxy host/IP (blank = auto-detect), Login proxy port
+
+**Connection**
+
+- Amazon Alexa account: Amazon domain (region), Cookie blob (from proxy login), Refresh token (alternative to cookie), State poll interval (ms)
 
 ## Requirements
 
-- A CamStack hub. An agent is used only when the placement above allows it.
+- Placement: default placement.
+- Python: Alexa installs `python/requirements.txt` into its own environment.
+- A CamStack hub. An agent is used only where the placement above allows it.
+
+## Documentation
+
+- [docs/addons/addon-import-alexa.md](https://github.com/camstack/server/blob/main/docs/addons/addon-import-alexa.md)
+- [packages/addon-import-alexa/AGENTS.md](https://github.com/camstack/server/blob/main/packages/addon-import-alexa/AGENTS.md)
+
+See [CHANGELOG.md](./CHANGELOG.md) for what changed in each version.
 
+<!-- readme:generated:end -->