Add iOS Live Activity webhook handlers to mobile_app

[rwarner]

Proposed change

Adds server-side support for iOS Live Activities in the `mobile_app` integration. This is the HA core companion to the iOS companion app PRs and the relay server PR.

Live Activities let Home Assistant automations push real-time state to the iOS Lock Screen and Dynamic Island. The iOS app handles the ActivityKit lifecycle; this PR adds the webhook handlers and notification routing that HA core needs.

How it works: When a notification contains `live_update: true` and a `tag`, the notify service looks up the stored APNs Live Activity token for that tag and includes it alongside the normal FCM registration token in the relay request. The relay places it in the FCM message's `apns.liveActivityToken` field — no separate APNs endpoint or credentials needed. If no per-activity token exists, it falls back to the device's push-to-start token (iOS 17.2+) to start a new activity remotely.

What this adds:

• `live_activity_token` webhook — stores per-activity APNs push tokens sent by the iOS app when an activity is created via ActivityKit
• `live_activity_dismissed` webhook — removes the stored token when the activity ends on device
• `SCHEMA_APP_DATA` validation for the optional `live_activity_push_to_start_token` field in device registration
• Notification routing in `notify.py` — extracts and forwards the Live Activity APNs token when `live_update: true` is present
• In-memory `DATA_LIVE_ACTIVITY_TOKENS` store, initialized in `init.py` and cleaned up on config entry unload

Type of change

• Dependency upgrade
• Bugfix (non-breaking change which fixes an issue)
• New integration (thank you!)
• New feature (which adds functionality to an existing integration)
• Deprecation (breaking change to happen in the future)
• Breaking change (fix/feature causing existing functionality to break)
• Code quality improvements to existing code or addition of tests

Additional information

• This PR is related to issue: "Live activities" for mobile apps OpenHomeFoundation/roadmap#52
• Link to documentation pull request: Add iOS Live Activities documentation companion.home-assistant#1303
• Companion iOS PRs: Adds iOS Live Activities support iOS#4444, Fix Live Activity compilation and display issues for Mac Catalyst iOS#4495, Enable Live Activities on iPad (iPadOS 17+) iOS#4574 (merged); Rename live activity webhook types to drop mobile_app_ prefix iOS#4585, Remove unused Live Activity registration fields iOS#4586 (open)
• Companion relay server PR: Add iOS Live Activity push support mobile-apps-fcm-push#278

[home-assistant]

Hey there @home-assistant/core, mind taking a look at this pull request as it has been labeled with an integration (mobile_app) you are listed as a code owner for? Thanks!

Code owner commands

Code owners of mobile_app can trigger bot actions by commenting:

• @home-assistant close Closes the pull request.
• @home-assistant rename Awesome new title Renames the pull request.
• @home-assistant reopen Reopen the pull request.
• @home-assistant unassign mobile_app Removes the current integration label and assignees on the pull request, add the integration domain after the command.
• @home-assistant add-label needs-more-information Add a label (needs-more-information, problem in dependency, problem in custom component, problem in config, problem in device, feature-request) to the pull request.
• @home-assistant remove-label needs-more-information Remove a label (needs-more-information, problem in dependency, problem in custom component, problem in config, problem in device, feature-request) on the pull request.

[Copilot]

Pull request overview

Adds Home Assistant Core support in the mobile_app integration for iOS Live Activities by introducing webhook handlers that store and clear per-activity APNs push tokens and emit lifecycle events for automations.

Changes:

• Extend SCHEMA_APP_DATA and constants to support Live Activities capability flags and push-to-start registration fields.
• Add update_live_activity_token and live_activity_dismissed webhooks that manage an in-memory token store and fire remote-origin bus events.
• Add a supports_live_activities() helper and webhook tests covering token storage, defaults, and cleanup.

Reviewed changes

Copilot reviewed 5 out of 5 changed files in this pull request and generated 2 comments.

Show a summary per file

File	Description
homeassistant/components/mobile_app/const.py	Adds Live Activity-related constants/events and extends registration SCHEMA_APP_DATA.
homeassistant/components/mobile_app/__init__.py	Initializes a new in-memory DATA_LIVE_ACTIVITY_TOKENS store under hass.data[DOMAIN].
homeassistant/components/mobile_app/webhook.py	Implements the new Live Activity webhook handlers and fires lifecycle events.
homeassistant/components/mobile_app/util.py	Adds supports_live_activities() helper based on stored app_data.
tests/components/mobile_app/test_webhook.py	Adds tests for storing tokens, default env behavior, and dismiss cleanup/event firing.

Comments suppressed due to low confidence (1)

tests/components/mobile_app/test_webhook.py:1398

• This test only asserts the HTTP status. To fully validate the contract of live_activity_dismissed (which returns empty_okay_response()), also assert the JSON body is {} (and optionally that no tokens were removed when none existed) to prevent regressions in response shape/side effects.

    resp = await webhook_client.post(
        f"/api/webhook/{webhook_id}",
        json={
            "type": "live_activity_dismissed",
            "data": {
                "tag": "nonexistent_activity",
            },
        },
    )

    assert resp.status == HTTPStatus.OK

[Copilot]

Pull request overview

Copilot reviewed 7 out of 7 changed files in this pull request and generated no new comments.

[Copilot]

Pull request overview

Copilot reviewed 7 out of 7 changed files in this pull request and generated 3 comments.

[Copilot]

Pull request overview

Copilot reviewed 7 out of 7 changed files in this pull request and generated 2 comments.

[Copilot]

Pull request overview

Copilot reviewed 7 out of 7 changed files in this pull request and generated 1 comment.

[Copilot]

Pull request overview

Copilot reviewed 7 out of 7 changed files in this pull request and generated 3 comments.

[edenhaus]

Please don't rebase after a review have started as this means a reviewer needs to review again the whole PR instead of the changes. Keep this in mind and also instruct claude to do it

[edenhaus]

Previously requested changes are not implemented. Drafting the PR. Not sure if the AI has reintroduced them or if they still pending to implement but due the rebase each commit is marked as new and I will not check each commit. Please make sure all previous requested changes are implemented correctly before marking the PR as ready for review.

and again we require the human in the loop and it feels from the comments that the are written completely by the AI

[edenhaus]

PR description not in sync with the changes

[rwarner]

Okay addressing some of the things here. This has unfortunately gotten to be a mess

we require the human in the loop and it feels from the comments that the are written completely by the AI

Yes, I did use AI for some responses that I felt like it could explain more sufficiently than I could. But I am personally involved in all of this. I apologize, as I was unaware this was against policy with OHF

PR description not in sync with the changes

Updated the description to match with current fork branch changes

don't rebase after a review have started

Sorry, again I was unaware this was a bad thing and now understand. It was 100+commits behind and I was simply doing this to try to fix CI solely.

---

Items that were tended to, as some things were lost during the rebase and I thought they were still in there:

• ATTR_LIVE_ACTIVITY_PUSH_TO_START_APNS_ENVIRONMENT removed from const.py: had been removed, rebase brought it back
• PUSH constants reordered in const.py: all push-related attrs grouped together, rebase undid the ordering
• SCHEMA_APP_DATA simplified: vol.Inclusive pair for APNS environment removed, push-to-start token changed to vol.Optional with plain cv.string, rebase reverted all of this
• Push-to-start return in notify.py: simplified to return app_data.get(...), rebase reverted it back to the walrus pattern
• Verbose/AI-sounding docstrings and inline comments: had been written in a verbose style, @edenhaus flagged them all as AI-sounding on Apr 30. After the rebase, it exposed them again

I have "unresolved" the comments that were lost during the rebase so they can be re-verified.

Would it be better for you @edenhaus if I just started a new PR at this point?