Index of /download/latest
Name Last modified Size Description
Parent Directory -
README.html 2022-07-22 16:38 49K
reactor-latest-22203-d7cd6357.zip.sha256 2022-07-22 16:37 100
reactor-latest-22203-d7cd6357.zip 2022-07-22 16:37 21M
reactor-latest-22203-d7cd6357.tar.gz.sha256 2022-07-22 16:37 103
reactor-latest-22203-d7cd6357.tar.gz 2022-07-22 16:37 12M
reactor-latest-22179-9f909b47.zip.sha256 2022-06-28 15:24 100
reactor-latest-22179-9f909b47.zip 2022-06-28 15:24 21M
reactor-latest-22179-9f909b47.tar.gz.sha256 2022-06-28 15:24 103
reactor-latest-22179-9f909b47.tar.gz 2022-06-28 15:24 12M
reactor-latest-22168-5ab4d6c2.zip.sha256 2022-06-17 13:20 100
reactor-latest-22168-5ab4d6c2.zip 2022-06-17 13:20 21M
reactor-latest-22168-5ab4d6c2.tar.gz.sha256 2022-06-17 13:20 103
reactor-latest-22168-5ab4d6c2.tar.gz 2022-06-17 13:20 12M
Reactor (Multi-Hub/System, aka MSR) Latest Builds
WARNING: This directory contains development builds that may not be fully verified/validated.
DOCKER USERS ON RASPBIAN BUSTER (ONLY) FOR RPi: Reactor images since 22021 require that you install an OS patch to run the Reactor image in a container. See the install instructions for the steps to install it.
BARE-METAL USERS: It is recommended that you update package dependencies when installing Reactor updates. After unpacking the Reactor archive, remove any existing package-lock.json
file from your Reactor install directory, and then run npm i --no-save --omit dev
to update package dependencies.
NOTE TO EZLO HUB USERS: Ezlo appears to have removed the API that allows a Lua script to be sent to the hub to run, as of their firmware version 2.0.1570.4. There is no replacement API that I can find, so the runlua
action is no longer available. At all.
22203
- Expressions: the
time()
function has been extended to allow parsing of date/time values in strings in forms beyond ISO-8601; most simple date/time forms should work, particularly those that closely adhere to your locale's default. A string that contains only a time will be converted to that moment on the current date; a string that contains only a date will yield midnight on that date. If a given string cannot be converted, an error will be thrown. Refer to the documentation for Expressions for more information.
- HassController: Bless Hass to 2022.7.6
- Docs: documentation for Reactions now includes additional information about rule-based reaction behaviors and action groups, and has been "modernized" to use the terminology of Multi-Hub Reactor rather than that of the Reactor for Vera plugin.
22179
- HassController: Fix an issue that may randomly affect/disable assignment of primary attributes (since 22118).
- Fix a problem in after...within (time-restricted) sequence conditions.
22178
- HassController: Set null state for switches and sensors when Hass reports them unavailable.
- HassController: Bless Hass to 2022.6.7.
- Docs: Improve details in Synology/Docker installation.
22168
REMINDER: As previously announced, all docker images are now named with the release branch and target architecture only. The latest
branch docker image for all x86_64/amd64 systems is now named latest-amd64
(was previously latest-generic-amd64
). The latest
branch image for armv7l, which includes Raspberry Pi systems on Raspbian Buster, is now named latest-armv7l
(was previously latest-raspbian-armv7l
). Please adjust your upgrade procedures and, if used, docker-compose or Portainer configurations accordingly.
- NUTController (for Network UPS Tools) is now available as an installable extra.
- Documentation updates to reflect updated installation archive and docker image names.
22149
- PR 0000322: EzloController: provide mapping for Xiaomi Mini Switch (a single-button remote).
- Rule: make sure clear of trouble state (on startup) is saved if necessary (so UI updates properly without need to refresh).
- VeraController: Hack for variables named
sl_
, which are the special Luup state variables that always send updates/call watches even when set to the same value they already have (all other state variables in Vera/Luup do not behave this way, they only trigger events when their values change). In particular, these sl_
states are changed when lock codes on locks are entered, or buttons on scene controllers are pressed. For these uses, it is important that a repeated use of the same code or button signals an additional event, so Vera/Luup's uses these special sl_
states for those. VeraController now inserts an extra _updated
attribute of the same name that can be used with the changes operator to detect when the sl_
states are updated. Refer to this forum post for more information.
22142
- PR 0000321: HTTP API
perform
action does not send response when it succeeds (clients then time out waiting for the response that never comes).
- PR 0000320: API Docs: Fix
entity
API examples.
22140
- Additional localization changes.
- HassController: Bless Hass to 2022.5.5
22136
NEW DOCKER IMAGE: A new docker image, or more correctly, architecture, has been added to the builds: aarch64. This is for 64-bit Arm (v8) systems, including the Raspberry Pi 4 on Raspbian Bullseye, and the NVIDIA Jetson Nano (2GB and 4GB versions).
- Additional localization updates.
- HassController: Bless Hass to 2022.5.4
22123
- Fix output not formatting correctly for certain errors in triggers and constraints.
- DynamicGroupController: Fix an exit from the update function that may not immediately release notifications on a modified group object (a fast exit when when no eligible entities match).
22118
Note: this release includes changes to package dependencies. Bare-metal users please run npm install --no-save --omit dev
to resolve.
IMPORTANT: This update includes some significant enhancements for entity tracking. On your first startup after upgrading, you may get a lot of alerts about new devices being discovered (i.e. existing devices are being noted as new) as the enhanced tracking learns what is "normal" for your system. This is expected behavior for this version on its first startup. Just clear the alerts and go on about your day. After that, you should only receive notices when new devices are added to a hub, or new hubs are configured in Reactor.
- PR 0000316: Variable Value condition with substitution in operand may replace expression with value in saved rule.
- PR 0000315: Improve alert message when a Rule-based reaction fails.
- PR 0000314: Fix "self-subscribe" exceptions logged after creating new Rule with local expressions and a Variable Value condition (exceptions clear after restart of Reactor).
- PR 0000312: Expressions
getEntity()
helper not listing or updating attributes correctly (fixed).
- Raspberry Pi Install Script: Support for 64-bit installation on Raspbian Bullseye.
- UI: Faster core startup brings up the UI more quickly, and does not wait for controller startups, so a delay in a controller becoming ready (e.g. its associated hub is offline) will no longer delay the UI being available.
- UI: You can now add an SSL/TLS certificate and have the UI and API served over HTTPS (see How-To in documentation).
- New actions in
sys_system
capability to tell a Controller instance to purge unused entities (i.e. that no longer exist on the hub but are still present in Reactor), delete an entity (from Reactor only, not from the hub/mesh/etc.), and rename an entity (in Reactor, not at the hub/mesh/etc.).
- UI/Entity Picker: You can now move the entity picker by dragging its title bar.
- UI/Entity Picker: The name search field will now also match on entity IDs.
- UI/Reaction editor: Changing from a group or while to another reaction type while editing would leave the conditions behind (they should be removed); fixed.
- Expressions: lexpjs updated, adds
yday
(day of year), isoweek
(ISO-8601 week number) and dst
(boolean) to dateparts()
function result.
- Status: Controller Status widget now sorts down/failed controllers first.
- Docs: Added How-Tos for serving media files from Reactor's built-in web server and set up HTTPS for the UI.
- HassController: Bless Hass version 2022.4.7.
22080
- PR 0000311: Vera Scene controller entities missing attributes in new and existing rules.
- PR 0000310: Dependent global variable may not update after editing parent.
- HubitatController: Because the HE events websocket passes all values as strings, the new fast-update process introduced in 22067 would change (for example) a previously-numeric attribute value to a string when updated by the hub. While this doesn't generally bother conditions or expressions, the type change affects InfluxFeed because InfluxDB cannot digest the type change. The data type declared by the hub during inventory is now stored and used to remap the events feed values to keep the data types consistent on the attributes. It must be noted, however, that the data types of extension attributes (
x_hubname_...
) are driven by the hub, and are therefore not guaranteed by Reactor (types are guaranteed for Reactor-defined capabilities, e.g. dimming
, value_sensor
, etc.). Users exporting extension attributes into InfluxDB are advised to always use explicit type setting for those attributes in their InfluxFeed configuration. This advisory has been added to the documentation for InfluxFeed.
- HubitatController: An inconsistency in the (HE) attribute names between their MediaPlayer and MusicPlayer capabilities with respect to transport state is now handled correctly, so that Reactor's native
av_transport.state
attribute shows a correct value regardless of which the device uses.
- SystemController: Will now issue system alerts unconditionally when disk space becomes critical (unless disk space monitoring has been disabled by user configuration), in addition to the (previously available) values and flags on the
reactor_system>system
(Reactor System) entity. It's also probably a good idea to add notifications (i.e. in your own rules) for such conditions raised by the system entity, if the user is not regularly looking at the Reactor UI. See the documentation for SystemController.
- SystemController: A
dst
(boolean) attribute has been added to the reactor_system>sun
(Sun Information) entity; it will be true when Daylight Saving Time is in effect, false otherwise.
- HassController: Fix
cover
capability handling on non-positionable covers (e.g. garage doors).
- Dashboard: New display for cover entities.
22069
- HubitatController: Fix a possible loss of attribute change across restarts of the hub (that is, when a value changes during a Hubitat restart but Reactor is not restarted).
22067
- PR 0000309: Exception while evaluating global reaction predicate (conditional group).
- HubitatController: Attempt to eliminate additional query to fetch full device data when a device-change event is received from the hub. Please see the documentation for cautions.
- UI will now highlight deprecated capabilities, attributes and actions when used.
- Bless Hass to 2022.3.3
22053
BREAKING CHANGE/FIX This version contains what may be a breaking change for some users. Some actions offer lists of predefined values (e.g. media_source.set
offers hdmi1
, hdmi2
, etc.). A bug in the Reaction editor was causing a numeric index value to be stored instead of the string value (i.e. it would store 0 rather than hdmi1
). The bug is now fixed, but any action like this previously created/edited may have had an invalid value stored in the rule or reaction to which it belongs, and this cannot be reliably automatically fixed, it generally requires user review. Most likely, these actions didn't work well for you anyway, because the erroneous numeric value would likely have given invalid results/behaviors/errors when attempted, and we just haven't noticed until now (they are fairly rarely-used actions, on the whole). The specific actions affected are: av_repeat.set_repeat
, muting.set
, media_source.set
, hvac_control.set_mode
, hvac_blower_unit.set_mode
, hvac_blower_swing.set_mode
, hvac_humidifier.set_moded
, hvac_dehumidifier.set_mode
, zwave_device.set_config
. Hopefully this list helps you narrow down what, if any, of your rules/reactions may be affected. Just take the rule/reaction into the editor, fix the new correct value and save.
- PR 0000308: Fix issue where delay action with substitition in delay may self-replace evaluated value in stored object.
- UI: Autogrow fields get more room for datalist controls.
- UI: Fix issue with some value lists incorrectly showing and storing index values rather than actual listed value; see BREAKING notice above.
- Bless Hass to 2022.2.9
22049
**NOTE: Bare-metal users should run npm i --no-save --omit-dev
to update packages for this release.
- Update lexpjs for new
pad()
function
- PR 0000307: Nested group would repeat interior actions outside group (reaction UI)
- Update to latest minor revisions of jquery-ui, bootstrap, popper. This now silences the long-endured warning when doing
npm i --no-save --omit dev
22044
- PR 0000306: Certain condition options not being saved for rule-based constraints.
- PR 0000305: Copying rule expression can renumber expression in source rule.
- PR 0000302: Reaction delay "from start" working same as "from this point".
- InfluxDB: Support for more extensive control of written measurements, including name and type modification; see docs
- Reactions: Fix an issue where missing device in a rule reaction does not flag trouble on the rule.
- Three new capabilities:
valve
, scene_activation
and battery_maintenance
. These will be fully integrated with eligible Controllers and Entities in a future release.
- Reactions: An error in a special form on the Comment action is fixed (simple notification).
- Expressions: New expression
case
statement; see docs
- Expressions: Fix sort in
median()
function.
- Expressions: An error in the
fileRead()
function has been fixed.
22028
- PR 0000301: Fix excess sensitivity to apparently unrelated devices in some conditions. I'm leaving this PR open; I think I know why this happened, and for my system it's working great, but I want to make sure I've covered all the bases, and because the fix was pretty aggressive, didn't inject anything new.
- Fix exception trying to subscribe to non-Observer in Variable Value condition.
- Logger: Allow
maxsize: 0
in log stream configuration for no log rotation at all.
- Fix condition value seen on Date/Time conditions in rule status display (cosmetic).
- HubitatController: implement Reactor
energy_sensor
capability; replaces x_hubitat_energymeter
, which is now deprecated.
22025
- VeraController: allow arrays for
filter_entity
and accept_entity
to be consistent with other similar applications.
- Fix an issue with setting a Rule's timebase before evaluation that may affect some rule-based expressions. Likely related to PR 0000301.
22023
- PR 0000296: Fixed rule throttling caused by constraints subscribing for events when they should not.
- PR 0000297: Duplicate report for 0000296.
- PR 0000298: Global expressions not updating correctly, not triggering rules correctly.
- Engine: New and very experimental Repeat While action (a form of group), repeats as long as its conditions are met. The group must have at least one condition or it will not run at all. The repeat will stop if either (a) the conditions result in false or null, or (b) if it's in a rule-based reaction, the contra-reaction is started by a change of rule state. It is quite possible to make reaction groups that never stop, so be careful with your logic here.
22022
- UI: Fix "Recently Changed Entities" not updating dynamically.
- UI: Fix an error in the new widget text on the Status panel.
- The
node-fetch
package requirement has been updated to version 2.6.7 or higher (in the 2.x release path). This version is patched against CVE-2022-0235 according to the package author. Bare-metal users will need to remove any existing package-lock.json
file in their Reactor install directory, and then run npm install --no-save --omit dev
. DO NOT run npm audit fix
— it will break your Reactor install.
- Docs: Update package install instructions for bare-metal installs, and in the Troubleshooting section.
- Docs: Update docker container installation instructions for users of Raspbian Buster (only) with additional steps to install
libseccomp2
patch required to run the image.
22021
- UI: Make it possible to bypass the About page at startup.
- UI: Status page now has movable, resizable widgets. A couple of new widgets have been introduced as well.
- UI: Adjusted column widths on Entities list to show more of canonical ID, as these can get long for Ezlo and Hass users. Hovering on the canonical ID shows the entire ID (if the column still isn't wide enough and it's clipped), and clicking on the ID automatically selects all of the text, ready for copy to clipboard.
- HubitatController: Fix
volume.set
action (media players)
- Support for
usermedia
directory inside config
; if present at startup, the built-in HTTP server will serve files from this directory (meant primarily for media/audio files, but will serve most common file types). This allows the user to serve files from the Reactor installation without the need to separately install Apache or another web server.
- HassController: Bless Hass to 2021.12.10
- Engine: predicates have been refactored to tidy up the code and remove some duplication of functionality created when reaction group contraints were introduced.
- Clean up the
reactor_inet_check.sh
script (in tools
).
- Docker: the OS base for armv7/RPi is now Alpine version 3.14 (was 3.12);
22010
- PR 0000291: HassController: Feature request for
reload_integration
on system entity.
- HassController: Bless Hass version to 2021.12.8
22004
- PR 0000289: Fix detection of loops in expressions, and add more aggressive checks for some conditions previously missed; make sure self-referencing expressions are not considered loops.
- EzloController: Update connection error recovery; cloud auth and token requests are now only done when the controller specifically denies the current token, or when too many connection retries occur. Implement retry decay, to further reduce queries to Ezlo's cloud. Overall, this makes EzloController more resilient in the face of Internet and Ezlo cloud outages.
- Update the little-used (that may be about to change) encrypted status packager to work in docker containers.
22001
- PR 0000284: Rule Editor: Add function to clone condition or group
- PR 0000287: Date comparison error in "between" that spans year (MDHM form); resets incorrectly at 01-01T00:00 Fix end check for next edge
21365
- HassController: Add
fire_event
action on system device, to fire any event.
- Deprecation warning when starting on nodejs version < 16 (still runs, just a notice).
- HubitatController: Enforce strict ordering on initial mode and HSM queries.
- HassController: Bless Hass version to 2021.12.7
- Docs: Add startup troubleshooting page to Troubleshooting section.
21362
- HubitatController: Fix sequencing of startup to prevent (again) mode/HSM race condition.
21360
- PR 0000282: DynamicGroupController: fix an error that could cause preloading of entities to fail (started in 21356).
- Updated lexpjs to 21360 to correctly handle assignment to object/array members.
21356
- PR 0000278: Fix an untranslated string in rule reaction name generator.
- SystemController: publish alert data on entity, making it available for use in conditions.
- EzloController: Fix bug where cancelling a house mode change causes the mode name to get the ID rather than the name.
- EzloController: support for additional items (power-related and seismicity).
- EzloController: remove
power_switch
as automatic capability on dimmable lights; not all Ezlo dimmable lights publish switch
items, so use the presence of the switch
item on a device as the trigger to extend power_switch
.
- EzloController: Fix an error thrown when handling certain extension items (e.g.
electric_meter_kwh
, only on some devices).
- HubitatController: Fix handling of TamperAlert capability.
- HubitatController: Add config
warn_unresponsive
(boolean) to turn off (when set false) warnings for quiet channel reconnects.
- HubitatController: Support for extension capabilities where an attribute like
current
is provided without a matching capability.
- VeraController: Log slow responses from hub (helps troubleshooting bottlenecks).
- Engine: Fix error in restore of running tasks across a reboot.
- PR 0000279: Fix an error that leaves Variable Value conditions in global reaction constraints with no variable list from which to choose (should list global variables).
21351
Users are advised only to upgrade to this release if they are affected by an issue related to the changes below; specifically, if you are not a user of Hubitat and you do not use constraints in rules or reactions, there is no need to upgrade to this release.
- HubitatController: Aggressive management of the event websocket connection, with additional diagnostic output by default.
- HubitatController: Fix error in setup of task queue (part of attempt to control pace of outgoing actions).
- Constraints: Loosen rules on condition options for constraints in rules (a stateful context), as opposed to those in global reactions (which are stateless).
- Docs: Improve description of the
time()
function so that it's clear it can convert time strings (in ISO 8601 format).
21349
- Make sure client API uses port for WebSocket connection, so the UI works when on a proxy or tunnel.
- Global reactions now support action groups with constraints.
- EzloController: Additional energy capabilities on certain devices/items.
- InfluxFeed: Fix an error in parsing the configuration for
select_capability
with attributes listed.
- The
suninfo
capability (used by the Sun Information entity reactor_system>sun
) has been expanded to include the elevation
and azimuth
of the sun's current position. The elevation
is given in degrees above the horizon. The azimuth
is given in degrees clockwise from North (compass direction).
- The
suninfo
attribute sun_angle
is now deprecated and will be removed from a future release. If you are using it in conditions, please switch to using elevation
, which is a better representation of the sun's position.
- A bug in the computation of
day_length
(in hours) in the extreme latitudes (i.e. where the sun does not cross the horizon at certain times of year) is fixed. During periods during in which the sun never rises, day length will be 0; during periods in which the sun never sets, it will be 24. Similarly, period
could give incorrect results and will now report correctly or the conditions.
21342
- PR 0000275: Fix sun angle not updating in
reactor_system>sun
(Sun Information) entity.
- PR 0000274: Fix missing localization of condition operand labels in rule editor.
- HassController: More tightly map reported service_data field types into Reactor types (to improve UI experience on Hass-native actions).
- Support "object" data type in action data more universally, not just in controllers that need it.
21338
- HubitatController: Fix handling of mode query response (injection from additional changes in 21336).
21337
- Document additional keys for logging in the
dist-config
template. There is also existing, but not well-organized, docs on the Logging page of the manual (which at the moment lives under Troubleshooting).
- HubitatController: ensure
x_hubitat
and x_hubitat_extra_attribute
capabilites are declared and extended so their attributes can be assigned as primary.
- PR 0000272: Localization issue in input fields for date/time condition.
- PR 0000273: Pulse after sustained for delay is shortened by the delay.
21336
If you have been with Reactor since before 21075 (March 15, 2021), your logging.yaml
configuration may have a relative path in the name
keys of the default streams (e.g. ./logs/reactor.log
). These must be changed to just a simple filename (e.g. reactor.log
). Reactor has been warning you at startup (in the log file) about this since 21075, if it applies to you (i.e. your logging config uses a relative path), but if you haven't seen it, you may not have changed it. The time to check it/change it is now, because the next version of Reactor that is released will not allow pathnames (relative or absolute) in this key, and will not run if it finds one.
- DynamicGroupController: map actions in known capabilities of selected objects, so that groups can perform actions on their members. For example, performing the
power_switch.off
action on a group will do so on all of its members that support that action.
- Logging: Fix support of log streams so that subsystems declaring their own log streams operate correctly; fix a number of long-standing annoyances in the configuration and handling (no changes to user configuration requirements except as noted above); improved "panic mode" (used when no configured stream is writable).
- Dashboard: improved layout for
string_sensor
capability objects.
- HubitatController: Bless firmware 2.3.0.113
- HubitatController: extend recent additions to capabilities (
string_sensor
) to the mode and HSM entities. Reduce reliance on the custom/hub-specific extension capability.
- HubitatController: New "type guessing", experimental, to try to reduce effort for this hub in particular in determining device types and primary attributes. This is a work in progress (but then, what isn't?).
- PR 0000271: Fix a missing localization in rule detail panel, operator in group titles (reported by @Crille).
- Improvements to
rpi-install.sh
script to handle upgrade of systemd script when upgrading nodejs.
- A number of internal fixes related to linting of the code.
- As always, a number of documentation updates.
21332
- DynamicGroupController: Fix missing initialization in preload for some selectors (blocking bug, no PR in Mantis).
- Documentation build fix so all documents receive correct left navigation.
- Condition operator is [not] EMPTY has been added to ease checking of group member arrays and other values for emptiness; see the docs Entity Attribute conditions for details on what "empty" means in this context.
21331
- DynamicGroupController: new controller to build dynamic groups. Refer to the docs for configuration information.
- Logger: new
recycle: true/false
flag, when true, each startup rotates the log file so the new run starts in a fresh file (makes some debugging easier); the file mode of the logs created can now be set by setting the mode
key.
- Bump recommended nodejs version to 16.13.0; versions 14 and 15 will continue to be supported through March 31, 2022; docker containers are built with recommended versions, and require no user action, but bare-metal users should check their node version (
node -v
) and if necessary make a plan to upgrade before 3/31.
- Update to lexpjs 31330; adds built-in
median( array )
function; provides extended first...in
syntax with (new) optional result expression;
- PR 0000270: [HubitatController] Apparently Hubitat needs action pacing like VeraController (that is, it can be overwhelmed if too many actions are sent at once). Pacing is now enabled with a default of 25ms delay between actions.
- PR 0000269: [UI] Rename Reaction dialog for global reactions prepopulates name from start of editor session rather than most recent name given if rename is used several times within one session.
- Bless Home Assistant to version 2021.11.5
21321
- HassController: Additional updates for event handling (
init
support).
- HubitatController: Map additional capabilities.
- Internal support additions for MQTTController
21313
- Bless Home Assistant to version 2021.11.2
- New system capability
button
to express state of a single button or contact closure.
- PR 0000268: Sun condition shows "not between" as "between" in rule detail card.
- Add
/alert/:tag
HTTP API endpoint (DELETE method); this deprecates /alert/:tag/dismiss
.
21307
- PR 0000266: An issue introduced at 21306 saves certain substitutions with the wrong data type.
- HubitatController: Resolve (hopefully) a race condition at startup.
21306
Note: this release includes changes to package dependencies. Bare-metal users please run npm update --no-save
to resolve.
- HTTP Request action now has explicit control over HTTP auth, with type selection (none, Basic, Digest) and credential fields (username and password).
- PR 0000265: Correct a string that is not translated in the alerts status panel.
- i18n: Found an additional string that was not localizable.
- The HTTP Request action will now suppress all alerts for any error it encounters, not just HTTP errors, if the "no error alerts" option is checked.
- Update lexpjs to get new array set functions:
arrayIntersection()
, arrayUnion()
, arrayDifference()
, arrayExclusive()
and arrayConcat()
.
21297
- PR 0000264: Fix an error in the rule editor on a particular value test used in several places that could cause the entered value of a condition option to not be saved (most notable on the "repeats within" field, but also found in two other locations).
- Update to lexpjs 21296 to get
sort()
function for arrays, and user-definable functions from expressions. Default sort in Reactor Engine for the implemention of expression sort()
function is (host) locale-aware. Please refer to the documentation for details.
21294
- PR 000263: Fix spurious log messages after deleting a global expression that contained a
getEntity()
.
- Fixed a UI issue with an expression being sorted to the top of the list then ending up at the bottom.
- The expression function
strftime()
is now locale-aware.
- Docker containers are now running on node version 16.
21292
- PR 0000262: Fix an error in handling date/time conditions with M/D across new year boundary.
- PR 0000261: HubitatController: Resolve an order of operations issue preventing extended attributes from being assigned as primary in local config.
- PR 0000258: (i18n) Fix string reference for condition option
- HassController: treat controller reporting NOT_RUNNING as an error and disconnect/retry
- Bless Hass to 2021.10.6
21286
- InfluxFeed now supports InfluxDB version 1.8+ and 2.0. InfluxDB versions prior to 1.8 are no longer supported. Please see the documentation for configuration details, as the configuration requirements for 1.x and 2.0 are different. Users of InfluxFeed also need to
npm update --nosave
if they are bare-metal installed.
- The behavior of rules when throttled has been improved. Note, however, that any time a rule is throttled, events could be missed (e.g. if a light that is a dependency of a rule is turned on and back off quickly when throttled, the rule may not "see" the on event).
- Ongoing documentation updates.
- Bless Hass to 2021.10.4
21285 (silent release)
- First version to contain a foreign language translation, Swedish! Thank you @Crille for your work on the translation and helping me get localization working.
- Address possible evaluation loop while using SetVariable in a rule reaction on a rule variable, where the value is an expression that contains a
getEntity()
reference.
- Documentation updates
- Further i18n fixes (thank you @Crille)
- Bless Hass to 2021.10.3
21281
- In prior versions, a reference to a variable (rule or global) that does not exist would cause an alert and "fail soft" by returning null. This (old) behavior actually hides such errors and makes them more difficult to locate, and generally speaking, you shouldn't be referring to things that don't exist. The new behavior is to throw an exception during the evaluation, which will more clearly highlight the error and make it easier to find and correct. If for some reason you still need the old behavior, you can set
deprecated_undefined_global_soft_fail
to true in the engine
section of reactor.yaml
, and such errors will soft-fail as before. The old behavior is deprecated, however, and will be removed in a few months.
- PR 0000260: Fix failure of HTTP Request (really underlying variable handling) to notice change in array of objects returned by request.
- PR 0000259: Need to more clearly highlight variables with errors in the expression editor. Failing expressions now receive orange highlight bars.
- Add
typeof()
expression function.
- Additional localization changes.
- New HTTP API additions: add alert, dismiss alert
- Bless Home Assistant to 2021.10.0
21277
- HubitatController: Fix a problem with setting RGB color.
- Fix an issue causing "Object not found" exceptions when evaluating a
getEntity()
call in a subcontext (e.g. within an each
loop).
- Fix a number of issues required for localization (thank you, Crille).
21275
NOTICE: This revision incorporates a breaking change to the recently-introduced matchEntities()
. See below.
- VeraController: Devices of type
...:FloodSensor1
now use the leak_sensor
(specific) capability; they maintain their previous use of the generic binary_sensor
capability for backward compatiblity with existing automations.
- EzloController: Fix a stack overflow that could occur under certain boundary conditions.
- OWMController: Fix a broken context initialization for
lexpjs
causing user-configured "extra data" fields with expressions to throw a soft error and report an incorrect (null) value.
- Improve interaction between Engine and UI when global expressions are created: they are now given an initial evaluation and their dependency tree built at that time. Previously, a rule reference or manual UI interaction (e.g. "Try Now" button press) was required to initialize it.
- Improve interaction between Engine and UI when global variables are deleted: the deleted variable is now removed from the Engine's evaluation dependency tree to avoid spurious "Expression Not Found" exceptions in the log for the then-deleted variable. These would stop after a restart, because the dependency tree was rebuilt at that time, but it should not take a restart to fix the tree.
- Fix an error in the parameters of the
isRuleSet
and isRuleEnabled
expression functions that would cause a constructor error when global expressions using these functions were initialized at system startup, before the Engine had loaded the rules. This error was exposed by the changes made to support global variable dependency graphs.
- When deleting system objects, wait until all notifications have been given and returned, to assure that the object being deleted is not actually deleted before the notified object has a chance to do whatever it needs to do. The former behavior had no adverse effect; this was a change to gain new behavior necessary to support the global variable dependency tree update on delete mentioned above.
- Fix a bug in the recording of the timestamp of modification of a global variable; it was using real time rather than virtual time, so when the engine was configured for "Test Time", it was recording incorrect (i.e. non-test time) values.
- The check for circular dependencies in the evaluation of global variables was relaxed to allow self-references (e.g.
series = push( series, value )
).
- BREAKING: The
matchEntities()
function now returns only a list of canonical IDs for matched entities. You will need to use the getEntity()
function to fetch current data for the entity if you need it. This was done because the previously-returned list of entity objects could grow "stale" (the data in the objects reflects the state at the time, not ever-changing and ongoing state as attributes change). And yes, this is exactly the kind of thing I said I try to avoid, but sometimes you just don't know all the side-effects until you see the thing in the wild. Sorry, everyone.
- New expression functions:
fileExists()
, fileRead()
, fileWrite()
. See the docs.
- Incorporates a hotfix made to 21270 for the
SetVariable
action on Vera hubs.
21270
- Fix an issue with EzloController not processing device match expressions correctly on newer lexpjs.
- Add
matchEntities()
function (see docs)
- Further localization improvements and fixes.
21267
- Change the evaluation algorithm for global variables to make them reactive. That is, global variables are now automatically reevaluated when dependent global variables or entities (from use
getEntity()
) change. They will also drive evaluation of rules when a rule-based expression or trigger condition references a global variable that changes.
- A new version of lexpjs supporting the above changes is being used; this version includes local scope for the interior of most statements, which may break some expressions (in particular, those that breach etiquette and create variables inside loops but access them outside).
- First version with localization capability. Users interested in localizing the user interface for their language/country can read the how-to documentation.
21258
- Warning and clear when changing operator on condition that would clear condition options.
- Fix Vera importer geotag handling.
- VeraController: add binary
x_vera_geotag.in_region
attribute.
- HassController: implement
x_hass_system.call_service
on system entities.
21256
- Fix issue with HTTP Request action post body causing exception;
- The maximum wait time for controllers to become available when Reactor starts is now configurable via the
startup_wait
key in the engine
section of reactor.yaml
. Users of the similarly-named startup_delay
, which is a fixed delay, are encouraged to use startup_wait
instead.
- The Rule detail display in the Rule Sets list was not correctly showing some non-primitive values (objects and arrays) correctly.
- HassController: Blessed Hass version 2021.9.6
21243
- HubitatController: Resolve exception thrown when attempting to set mode.
- HassController: Blessed Hass version 2021.8.8
21239
- Expression functions
strftime()
and format()
added. See the updated documentation.
- Direct browser (via HTML attributes) to disable spellcheck on various fields where it's inappropriate (e.g. HTTP Request action URL, headers and data).
- Updated to latest lexpjs, which has itself been updated to (hopefully) support Unicode alphabetic characters in identifier names.
- Allow expressions to have Unicode characters in their names (parity with lexpjs).
- Additional preparation for localization in UI and engine. For example, non-US users should notice that lists sorted alphabetically now appear in a more natural order for their configured language, rather than "ASCII" (character code ordinal) sorting.
21237
- EzloController: Tone down the warnings about disabling ECC ciphers for Atom; that's only needed for local access.
- PR 0000245: Fixed an issue with a hang caused by the attempt to actively stop a reaction that is blocked waiting for a child reaction (reaction group) to finish.
- PR 0000252: Enable power_switch capability for siren category on eZLO hubs.
21236
- Prototypical support for Ezlo Atom and PlugHub in EzloController;
- Be less aggressive with module loading in app.js for more permissive first-time startup;
- Simplify reaction stop for child tasks;
- Numerous small bug fixes/gnats in UI;
- Documentation updates and corrections.
21228
- Home Assistant up to version 2021.8.6 supported; the online version of the manual will now state the current supported versions;
- Fix an error in
OWMWeatherController
that could cause it to stop updating;
- Unify the approach to entity filtering on all hub interface classes (controllers); this works for device entities only; it may be extended to other entities later;
- Improve error detail in messages for
EzloController
during auth phase;
- Add
isRuleSet()
and isRuleEnabled()
functions to expressions extensions;
- Implement
set
action for lock
and passage
capabilities (makes them more easily scriptable in some cases);
- Fix a place in the UI where 24-hour time was not being displayed.
21221
- PR 0000248: Date/time restore when start is Jan comes back as "(every month)".
- Feature: Trouble signal on rules (first pass).
- VeraController: set room ID as extended attribute.
- NotifyTelegram: Add plain text formatting as explicit default override.
- Documentation updates and corrections.
21219
- PR 0000237: Reactor for Vera Importer imports date conditions off by one month.
- PR 0000243: Rule status display not highlighting TRUE groups like R4V.
- UI: Handle booleans with datalist so substitution can be used.
- Docs: Add example for
performAction()
21218
- All Controllers: Add "set" action to "power_switch" capability
- Expose additional system entity attributes for authorization state on EzloController
- Deeper sanity-checking of controller IDs in config
- Improve HTTP startup error trap (detects attempts to run multiple instances)
- Fix a bug where stopping WSAPI during a startup abort logs an exception
- Ezlo: Quiet implementation warning for x_ezlo_object attributes
- Hubitat: Handling for MediaPlayer capability; improved implementation specificity
- The use of
app.sh
for running Reactor is now deprecated; references to this script have been removed from the installation documentation.
21213
- PR 0000234: Feature request: add "ignore exit code" option to Shell Command action.
- Added
shell_command_timeout
and shell_command_output_limit
configs for Shell Command action.
- Improved capture of shell exit code and diagnostic output for Shell Command action.
- Add script (in
tools
) to install Reactor as a Windows service (on Windows only, of course).
- Simplify prototypical docker-compose.yaml file.
- Additional/trivial documentation updates and corrections.
- Improved the alert text for errors in Rule-based expressions.
21206
- Bless/support for latest HomeAssistant 2021.7.4.
21203
- PR 0000233: Fix primary attribute errors on VeraController Fibaro FGRM222 and RGBController plugin.
21202
- Continued effort on ir_remote and rf_remote for eZLO (PR 0000231).
21201
- The
remote
capability is now ir_remote
, and a new rf_remote
capability has been added. This is a breaking change, albeit for a single user currently, so it seems like the second-best time to make such a change.
- PR 0000231: ir_remote.send_codes is sending the wrong parameter key
21200
- Fix
remote.send_codes
not working
- Fix banner title.
- "Manual" (docs) link now goes to online docs if local docs are not installed.