Reactor-Editor / Reactor-ui-Status Errors

[toggledbits]

Build 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

[toggledbits]

Build 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
• 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)

[toggledbits]

Build 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

[toggledbits]

Build 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 nodejs version 16.

[toggledbits]

Build 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.

[toggledbits]

Build 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().

[toggledbits]

Build 21307

• PR 0000266: An issue introduced at 21306 saves certain substitutions with the wrong data type.
• HubitatController: Resolve (hopefully) a race condition at startup.

[toggledbits]

Build 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.

[toggledbits]

Build 21321

• HassController: Additional updates for event handling (init support).
• HubitatController: Map additional capabilities.
• Internal support additionals for MQTTController

MQTTController - Build 21321

• Fix incorrect scope reference is tasmota_generic_relay payload.
• Additional helpful debug.

Upgrading MQTTController, which is a standalone/add-on component, is the same procedure as initial installation.

[toggledbits]

Build 21331

Please note that Hubitat has released version 2.30 of its firmware, but it has not yet been tested with HubitatController and is not yet supported.

• DynamicGroupController: new controller to build dynamic groups. Refer to the docs for configuration information.
• Logger: new recycle 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; refer to docs.
• 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

MQTTController - Build 21331

• More carefully guard sensors (in templates) from payloads that don't contain the sensor data (i.e. avoid setting null value if an update is published with data missing).
• Additional templates for Tasmota and Shelly.
• Documentation updates and clarifications.

[toggledbits]

Build 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.

[toggledbits]

Build 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.

[toggledbits]

Build 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.

[toggledbits]

Build 21338

This is a hotfix build for users of Hubitat only, and specifically for users of Hubitat Modes. If you do not use Hubitat Modes, or Hubitat at all, you do not need to upgrade to this version.

• HubitatController: Fix handling of mode query response (injection from additional changes in 21336).

[toggledbits]

Build 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.

[toggledbits]

Build 21349

If you grabbed this release before 06:00 on 16-Dec-2021 UTC, please grab it again and reinstall. There was an issue with the next-day rollover computing sunset times that I fixed in-line.

• 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.

[toggledbits]

Build 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).

[toggledbits]

Build 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).

HubitatController - Additional Notes

The connection health probes have some new settings, described in the docs, to make the health checks as reliable as possible and eliminate false positives in the quiet channel checks. Primary among these is recognition of a device under control of the Hub Information (community) driver. I recommend that Hubitat users install this driver (and create a device that uses the driver, and publish that device through Maker API), as it has some predictable behaviors that make it perfect for health checks, and it gives you access to other information about the hub you may find useful in Reactor. This is not required; just recommended.

[toggledbits]

Build 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.

[toggledbits]

Build 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.