EchoMuse v2.9.13

v2.9.13 — hold the action button, and a light sensor Amazon hid

Two new things your Echo can tell Home Assistant, and one fix to how it
cancels.

Hold the action button

• Hold it for about three quarters of a second and it sends an event to
  Home Assistant instead of starting a voice turn. It appears as an
  'Action Button' entity you can pick straight from the automation editor
  — no YAML, nothing to guess.
• A normal press is unchanged: starts a voice turn, cancels one in
  progress, still instant.
• If you are used to holding the button to start a turn, that will now do
  nothing locally. A tap is the way.
• Double and triple presses are deliberately not included. Detecting them
  means delaying every single press to check whether another is coming,
  which would make the button feel slower for everyone.

Ambient light

• The Dot has a light sensor that Amazon's own software never exposed —
  it does not appear anywhere in Android's sensor list. It works, and it
  is quick: a hand over the top takes it from a lit room to zero and back
  within a second.
• It appears in Home Assistant as an 'Ambient Light' sensor in lux. A
  meaningful change — someone switching a lamp on — is reported straight
  away; otherwise it updates about every thirty seconds.
• Useful for 'only if it's dark' conditions, or for driving something else
  in the room by daylight.
• A device without the sensor reports nothing rather than a misleading
  zero, because zero lux is a real reading.

Fixed

• Pressing the action button during a spoken response now stops the audio.
  Previously the light ring cleared but the device carried on talking to
  the end of the answer.

Under the hood

• The startup script now keeps a small permanent record of its own
  decisions, so a device that fails to come back after an update can
  explain why afterwards. It takes effect on the next restart after this
  update, and the controller collects it automatically.

Both new entities appear on their own; nothing to configure. Requires
nothing of you — existing settings, wake word assets and the rollback slot
are untouched.

What's Changed

• Action-button cancel, ambient light events, supervisor log, and the docs split by @wilbowes in #58

Full Changelog: v2.9.12...v2.9.13