phynplus.yaml

######################################################################
# @CCOSTAN - Follow Me on X
# For more info visit https://www.vcloudinfo.com/click-here
# Original Repo : https://github.com/CCOSTAN/Home-AssistantConfig
# -------------------------------------------------------------------
# Phyn Plus Water Shutoff - Leak detection and auto shutoff
# Related Issue: 1550
#  Push action buttons + Activity feed + Repairs issue while valve is closed.
# -------------------------------------------------------------------
# Info: https://www.vcloudinfo.com/2020/05/phyn-plus-smart-water-shutoff-device.html
# Blog: https://www.vcloudinfo.com/2026/06/home-assistant-leak-detection-automations.html
# Video: https://youtu.be/xbhgWnomFYI
# HACS: https://github.com/jordanruthe/homeassistant-phyn
# Product: https://amzn.to/2Zy3sbJ
# Notes: This package references only Phyn entities confirmed in this HA registry.
# Notes: Add alert entities only after Home Assistant creates real registry entries.
######################################################################

script:
  phyn_send_actionable_leak_notification:
    alias: "Phyn Send Actionable Leak Notification"
    mode: parallel
    fields:
      source:
        description: "Caller context for trace/debug visibility."
        example: "initial"
    sequence:
      - service: script.notify_engine_two_button
        data:
          title: "Phyn Leak Detection"
          value1: "Phyn is sensing a leak and turned off the water. Please verify."
          who: "parents"
          group: "Phyn"
          title1: "Turn Water On"
          action1: "PHYN_WATER_ON"
          title2: "Snooze 30m"
          action2: "SNOOZE_PHYN_NOTIFICATION"
          icon1: "sfsymbols:arrow.up.circle"
          icon2: "sfsymbols:clock"
          level: "critical"

automation:
  - alias: 'Phyn ShutOff Notification'
    id: 78bbd270-ee1e-4b3d-80fd-44ce7c66dab5
    mode: single

    trigger:
      - platform: state
        entity_id: valve.phyn_shutoff_valve
        to: 'closed'

    condition:
      - condition: state
        entity_id: binary_sensor.phyn_leak_test_running
        state: 'off'

    action:
      - service: script.send_to_logbook
        data:
          topic: "WATER"
          message: "Phyn detected a leak and shut off the water. Please verify."

      - service: repairs.create
        data:
          issue_id: "phyn_leak_shutoff"
          title: "Phyn leak shutoff"
          severity: "critical"
          persistent: true
          description: >-
            Phyn detected a potential leak and automatically closed the main water valve.

            Verify there are no active leaks before restoring water service.

      - service: script.phyn_send_actionable_leak_notification
        data:
          source: "initial"

      - service: persistent_notification.create
        data:
          title: '🚨 Phyn Leak Detection Alert'
          message: |
            **CRITICAL**: Phyn has detected a potential leak and automatically shut off the main water supply.

            **Action Required**: Please verify there are no leaks in the house before turning the water back on.

            **Time**: {{ now().strftime('%Y-%m-%d %H:%M:%S') }}
          notification_id: 'phyn_leak_detection'

  - alias: Turn Phyn Water On
    id: 1f295bb8-8925-4b22-PHYN-9fe079b295a8
    trigger:
      platform: event
      event_type: mobile_app_notification_action
      event_data:
        action: PHYN_WATER_ON
    action:
      - service: valve.open_valve
        target:
          entity_id: valve.phyn_shutoff_valve

      - service: script.notify_engine
        data:
          title: 'Phyn Leak Detection'
          value1: 'Request Received. Attempting to Turn the Water back on.'
          who: 'parents'
          group: 'Phyn'
          level: 'time-sensitive'

      - service: script.speech_engine
        data:
          value1: >
            I have been asked to Turn the House Water back on.  Please verify there are no leaks in the house.
          call_no_announcement: 1

  - alias: Snooze Phyn Notification
    id: 2f295bb8-8925-4b22-PHYN-9fe079b295a8
    trigger:
      platform: event
      event_type: mobile_app_notification_action
      event_data:
        action: SNOOZE_PHYN_NOTIFICATION
    action:
      - delay: '00:30:00'
      - service: script.phyn_send_actionable_leak_notification
        data:
          source: "snooze"

  - alias: Dismiss Phyn Notification When Valve Opens
    id: 3f295bb8-8925-4b22-PHYN-9fe079b295a8
    trigger:
      - platform: state
        entity_id: valve.phyn_shutoff_valve
        to: 'open'
    action:
      - service: repairs.remove
        continue_on_error: true
        data:
          issue_id: "phyn_leak_shutoff"
      - service: persistent_notification.dismiss
        data:
          notification_id: 'phyn_leak_detection'