Skip to content

v0.3.0

Choose a tag to compare

@github-actions github-actions released this 11 Nov 05:06
· 20 commits to main since this release
5237a75

The v0.2.0 tag never reached PyPI (it pointed at a commit still versioned 0.1.0), so this release carries 0.2.0's changes too.

Breaking Changes

  • Tool Namespacing: All MCP tools are now prefixed with harmony_ (harmony_get_status, harmony_list_activities, harmony_list_devices, harmony_list_commands, harmony_start_activity, harmony_power_off, harmony_send_command) to avoid naming collisions in MCP clients when run alongside sibling smart home servers.
  • CLI Shorthand: The call CLI subcommand accepts both prefixed (harmony_get_status) and legacy/shorthand names (get_status, status).

Security

  • Network Topology Masking: Internal hub LAN IPv4 addresses in harmony_get_status payloads are sanitized with mask_ip (e.g. 192.0.2.20 -> x.x.x.20) to prevent leaking local network topology to LLMs over stdout.

Documentation

  • HARDWARE_VALIDATION.md step 7: the Office Hub results for hold_ms (held presses acted as one tap on the LG TV and Onkyo). H-HOLD is unchanged in assumptions.py until a configured hold action is checked.
  • HARDWARE_VALIDATION.md steps 6, 8 and 9: results of the 2026-11-04 run on the Office and Bedroom hubs (presses, start/switch, multi-hub power off, the busy guard, config push, reconnect), with what each did not show.

Assumptions (hardware, 2026-11-04)

  • H-FORCE-OFF is now hardware-contradicted: a forced power off sent during a start from the physical remote was refused by the hub ("Activity in progress"). power_off(force=true) is unchanged; it still skips this server's own busy guard, but the hub can refuse it. README and CLAUDE.md say so. Whether force helps a hub that is really stuck is untested.
  • H-CONFIG-PUSH is now hardware-verified: an activity renamed in the Harmony app showed up in harmony_list_activities with no restart.
  • H-RECONNECT stays simulator-only, with a note: a hub unplugged and replugged came back reachable: true on its own, but the re-read of state after a reconnect wasn't exercised.