Bump yandex_ynison to v2.2.0: handoff state-sync FSM and opt-in stream-mode UI integration

[trudenboy]

Summary

Bump yandex_ynison plugin provider to v2.2.0. The diff against dev introduces a real two-way state-sync layer for the experimental handoff playback mode and adds an opt-in stream-mode UI integration so MA's player card renders fully while a PluginSource is active.

Source: trudenboy/ma-provider-yandex-ynison@v2.2.0.

Highlights

Handoff state-sync

Two-way sync between the Yandex Music app and MA's player queue is driven by an explicit HandoffPhase FSM (IDLE / ACTIVATING / PLAYING / PAUSED / ENDING).

• Centralised dispatcher: _handoff_activate → _apply_track_change / _apply_idle_resume / _apply_same_track_sync.
• Idempotency cache (1 s TTL); _cancel_pending_play_media() cancels the in-flight play_media task before issuing a new one.
• Pause / resume routed through cmd_pause / cmd_play (avoids the queue's _watch_pause watchdog dropping to IDLE on long pauses).
• Same-URI resume goes via play_media(REPLACE) + seek wrapped in cmd_pause / seek / cmd_play (avoids the audible 0-then-jump).
• Natural-end auto-advance: PLAYING → IDLE queue-state transition, gated on _expected_phase == PLAYING and _is_at_natural_end_of_track. Heartbeat-side polling (≤ 5 s) as a fallback when MA's event bus drops the transition.
• Echo classification: author-only AND check on both queue.version.device_id and status.version.device_id. Lamport-style watermarks are intentionally not used — Ynison documents version.version as random(int64) and re-stamps it.
• Reconnect settle window (2 s) drops the first inbound state after WS reconnect; _connect_state always sends a fresh initial state.
• Shared helpers used by both stream + handoff: _classify_drift (queue-rebuild guard, prevents stream mode from treating a Ynison progress=0 echo as a seek), _pick_resume_position.
• _handoff_pause echoes paused=True to Ynison immediately and bumps the heartbeat watermark so the next tick doesn't race the user's pause.

Stream-mode MA UI integration (opt-in)

New advanced config — enable_ui_integration (default off) — publishes a frontend-only fake queue under the provider's instance_id, so MA's UI renders the seek bar, signal-chain panel, and quality indicator while a PluginSource is active.

• _register_plugin_queue fires QUEUE_ADDED / QUEUE_UPDATED events without touching player_queues._queues — backend command routing stays on the PluginSource callbacks.
• _set_player_output_format stamps player.extra_data["output_format"] for the signal-chain panel; cleared in unload() and _clear_active_player.
• _signal_seek_to_frontend snaps the frontend bar via a public QUEUE_TIME_UPDATED event (no private-attribute writes).
• Queue state derived from the live YnisonState.is_paused flag so pause / resume reflect immediately.
• Off by default because the integration relies on private frontend behaviours and can interfere with "Play Now" on local content while the source is active.

Config UX

• playback_mode and Device name in Yandex Music (publish_name) moved out of the advanced section.
• New advanced toggle enable_ui_integration (hidden in handoff mode).

Stats

10 files changed, 2958 insertions(+), 89 deletions(-) (vs dev). One new test file: tests/providers/yandex_ynison/test_provider_handoff.py (993 lines). 283 unit tests, ruff and mypy clean on the source repo.

Test plan

• Unit tests, ruff, mypy — green
• Live-tested in both playback_mode: stream and playback_mode: handoff: track change, pause / resume (short and long), next / prev, seek (forward and backward), mid-track handoff from the Yandex Music app, natural-end auto-advance.
• Stream-mode UI integration live-tested with multiple track formats (FLAC 44.1/16, 44.1/24, 48/24, AAC 44.1/16). Toggle on/off paths verified.

CI sync

Published via trudenboy/ma-provider-tools/reusable-sync-to-fork.yml (target upstream/yandex_ynison).

[Copilot]

Pull request overview

Updates the yandex_ynison provider to upstream v2.2.0, bringing in a handoff-mode FSM rewrite, improved echo/reconnect handling in the Ynison client, and an opt-in stream-mode UI integration that publishes a frontend-only “fake queue” for richer UI rendering.

Changes:

• Reworks echo detection and reconnect behavior in YnisonClient (AND-based author checks + post-reconnect settle window + session params update).
• Adds a handoff playback mode with explicit FSM bookkeeping, heartbeat progress reporting, and idempotency/REPLACE handling.
• Adds opt-in stream-mode UI integration (fake queue events + output format stamping) and format prefetch/hinting to improve output format accuracy.

Reviewed changes

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

Show a summary per file

File	Description
music_assistant/providers/yandex_ynison/__init__.py	Adds playback mode selection and UI integration / handoff heartbeat config entries; features vary by mode.
music_assistant/providers/yandex_ynison/constants.py	Introduces new config keys and handoff tuning constants.
music_assistant/providers/yandex_ynison/protocols.py	Extends the Yandex Music provider protocol with instance_id for instance-scoped URIs.
music_assistant/providers/yandex_ynison/provider.py	Implements handoff FSM + heartbeat, stream-mode UI integration (fake queue), and format prefetch/hints.
music_assistant/providers/yandex_ynison/streaming.py	Adjusts default lossless PCM params to 44.1kHz.
music_assistant/providers/yandex_ynison/ynison_client.py	Adds reconnect settle logic, session param updates, and AND-based echo classification.
tests/providers/yandex_ynison/test_provider.py	Updates/extends provider tests for prefetch + normalized format behavior.
tests/providers/yandex_ynison/test_provider_handoff.py	New comprehensive test suite for handoff mode FSM/heartbeat/idempotency behavior.
tests/providers/yandex_ynison/test_streaming.py	Updates streaming tests for 44.1kHz lossless defaults.
tests/providers/yandex_ynison/test_ynison_client.py	Updates Ynison client tests for new echo + reconnect semantics.