[moyoseph]

Problem

While streaming (Punktfunk), pressing a button on the client's controller powered the TV on, as if the controller were plugged into the box.

Streaming hosts inject the remote client's gamepad as a virtual device. Punktfunk emulates it as a Valve Steam Deck / Steam Controller 2 over UHID or usbip, carrying the same 28DE vendor ID as a real Steam Controller. The hidraw monitor matched it as the couch controller and, with steam_controller.wake (default on), woke the TV mid-stream. Its evdev events also counted as key presses. Nothing told the daemon a stream was running either: detection only covered Sunshine's log.

Fix

• inputdev.is_synthetic() classifies a node by its sysfs origin: /sys/devices/virtual/… (uinput, UHID) or vhci_hcd (usbip) means injected.
• HidrawMonitor skips virtual Valve nodes entirely.
• InputMonitor tags virtual evdev nodes. The agent reports their input as activity with key: false, and the daemon's own WakeOnInput ignores them.
• The daemon suspends wake-on-input while streams.streaming is set.
• lgtvc setup hidraw-scan marks virtual pads.
• docs/external-api.md documents Punktfunk session.started / session.ended hooks; CHANGELOG updated.

Verification

• ruff + mypy clean; full suite green (549 passed). New tests cover the sysfs classification (physical / uinput / UHID / vhci), hidraw skip, agent key→activity-only, WakeOnInput filter, the no-wake-while-streaming gate, and the hidraw-scan marking.
• Ran the classifier read-only on a real Bazzite box: K400 keyboard and the SC2 puck hidraw nodes stay physical; only steamos-manager's uinput device is flagged virtual.

🤖 Generated with Claude Code