fix(proto): pin protobuf gencode to 6.32.0 for Home Assistant compatibility

AGENTS.md

@@ -87,7 +87,9 @@ All exceptions inherit from `TeslaFleetError(BaseException)`.
 
 ### Protobuf
 
-Generated protobuf files live in `tesla/vehicle/proto/` and are excluded from ruff and pyright. Do not edit these directly.
+Generated protobuf files live in `tesla/vehicle/proto/` and are excluded from ruff and pyright. Do not edit these directly — regenerate them with `tools/regenerate_protos.sh` (needs `protoc` on `PATH`).
+
+**Runtime-version pin (Home Assistant compatibility).** The gencode stamps a `ValidateProtobufRuntimeVersion(major, minor, patch, …)` call, and protobuf refuses to load gencode that is *newer* than the installed runtime (`gencode X > runtime` → `VersionError`). Home Assistant core pins `protobuf==6.32.0`, so the gencode must be stamped **≤ 6.32.0** or it breaks in HA. The generator version is the `protoc` version: under unified protobuf versioning, `protoc vX.Y` (`libprotoc X.Y`) stamps Python gencode `6.X.Y`. So to target runtime 6.32.0, regenerate with **protoc v32.0** (`protoc-32.0-linux-x86_64.zip` from the protobuf GitHub releases). The `protobuf>=6.32.0` floor in `pyproject.toml` must match the gencode version — never set it below the stamped version, or installs that resolve an older protobuf will hit `VersionError` at import.
 
 ## Code Style
 

pyproject.toml

@@ -4,7 +4,7 @@ requires = ["setuptools>=77.0"]
 
 [project]
 name = "tesla_fleet_api"
-version = "1.5.1"
+version = "1.5.2"
 license = "Apache-2.0"
 description = "Tesla Fleet API library for Python"
 readme = "README.md"
@@ -21,7 +21,7 @@ dependencies = [
     "aiofiles>=24",
     "aiolimiter>=1",
     "cryptography>=43",
-    "protobuf>=6.31.1",
+    "protobuf>=6.32.0",
     "bleak>=0.22",
     "bleak-retry-connector>=3.9",
 ]

tesla_fleet_api.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: tesla_fleet_api
-Version: 1.5.1
+Version: 1.5.2
 Summary: Tesla Fleet API library for Python
 Author-email: Brett Adams <hello@teslemetry.com>
 License-Expression: Apache-2.0
@@ -16,7 +16,7 @@ Requires-Dist: aiohttp>=3
 Requires-Dist: aiofiles>=24
 Requires-Dist: aiolimiter>=1
 Requires-Dist: cryptography>=43
-Requires-Dist: protobuf>=6.31.1
+Requires-Dist: protobuf>=6.32.0
 Requires-Dist: bleak>=0.22
 Requires-Dist: bleak-retry-connector>=3.9
 Dynamic: license-file

tesla_fleet_api.egg-info/requires.txt

@@ -2,6 +2,6 @@ aiohttp>=3
 aiofiles>=24
 aiolimiter>=1
 cryptography>=43
-protobuf>=6.31.1
+protobuf>=6.32.0
 bleak>=0.22
 bleak-retry-connector>=3.9

tesla_fleet_api/__init__.py

@@ -1,7 +1,7 @@
 """Tesla Fleet API"""
 
 __author__ = "hello@teslemetry.com"
-__version__ = "1.5.1"
+__version__ = "1.5.2"
 
 from tesla_fleet_api.const import Region, is_valid_region
 from tesla_fleet_api.tesla.bluetooth import TeslaBluetooth

tools/regenerate_protos.sh

@@ -9,7 +9,13 @@
 # Usage:
 #   tools/regenerate_protos.sh
 #
-# Requirements: protoc (>= 3) on PATH.
+# Requirements: protoc on PATH. The protoc version determines the version
+# stamped into the generated gencode: under unified protobuf versioning,
+# protoc vX.Y emits Python gencode 6.X.Y. Because protobuf refuses to load
+# gencode newer than the installed runtime, and Home Assistant core pins
+# protobuf==6.32.0, regenerate with protoc v32.0 (-> gencode 6.32.0) and keep
+# the protobuf floor in pyproject.toml in sync with the stamped version. See
+# the "Protobuf" section of AGENTS.md for the full rationale.
 
 set -euo pipefail
 

upgradeProtoc.sh

@@ -1,4 +1,4 @@
-PROTOC_VERSION=31.1
+PROTOC_VERSION=32.0
 
 protoc --version
 curl -OL https://github.com/protocolbuffers/protobuf/releases/download/v$PROTOC_VERSION/protoc-$PROTOC_VERSION-linux-x86_64.zip