refactor: migrate Python API to websockets asyncio API (>=14.0)

[carvalhoviniciusluiz]

Closes #57

Summary

Imports upstream gnachman#607 ("Migrate Python API to websockets new asyncio API >=14.0") into the fork. This is a compatibility fix for our Tier 1 daemon, which imports the iterm2 Python library. No feature flag — it's an infra/compat change.

The change removes the legacy/new websockets API compatibility shim and migrates the iterm2 Python lib directly to the websockets 14.0+ asyncio API:

• InvalidStatusCode → InvalidStatus (status now read via response.status_code)
• extra_headers → additional_headers
• response_headers → response.headers
• websockets.legacy.client.connect → websockets.connect
• websockets.legacy.client.unix_connect → websockets.unix_connect

websockets version change

api/library/python/iterm2/setup.py: install_requires pin changed from 'websockets' (unpinned) to 'websockets>=14.0'.

Files changed

• api/library/python/iterm2/iterm2/connection.py — API migration
• api/library/python/iterm2/setup.py — pin websockets>=14.0
• api/library/python/iterm2/tests/test_connection.py — new tests (added by the upstream PR)

Test status (honest)

Ran the new tests/test_connection.py in an isolated venv (Python 3.11, websockets 15.0, pytest, pytest-asyncio) with PYTHONPATH pointed at the lib: 12 passed (asyncio_mode=auto). The only output noise was unrelated Python enum DeprecationWarnings from mainmenu.py. No app/Xcode build was run — this change is Python-lib-only.

Provenance

Adapted from upstream gnachman#607.

Apply notes

Patch applied cleanly onto current master (no conflicts, no rejects) — these three files are untouched by the fork.

🤖 Generated with Claude Code

[carvalhoviniciusluiz]

Review by tech-lead — APPROVED ✅ (verificado de verdade — lib Python, não o app).

Aplicou limpo (3 arquivos, sem conflito). Migração completa p/ a nova API asyncio do websockets (grep confirma zero refs legadas: extra_headers/InvalidStatusCode/response_headers/.legacy); pin websockets>=14.0. O subagente rodou tests/test_connection.py em venv isolado (websockets 15.0) → 12 passed. Beneficia diretamente o nosso daemon (Tier 1). Proveniência: Adapted from upstream gnachman#607. Sem ressalvas.