build(tesla): bump tesla-protocol floor to >=1.4.0 for protobuf 7 support (#140)

* Bump tesla-protocol floor to >=1.4.0 for protobuf 7 compatibility

tesla-protocol 1.4.0 declares protobuf>=6.32.0,<8, unblocking dependents
that need to move to protobuf 7 (Home Assistant's protobuf pin included).
The proto bump renamed NavigationSuperchargerRequest.order to
remote_nav_trip_order and added four new GetVehicleData substates
(vehicle_config, soh_state, vehicle_detail_state, display_state), now
wrapped as BLE readers; a fifth (getLegacyVehicleState) is allowlisted
pending live verification of how it differs from the existing
legacy_vehicle_state() reader.

Version bumped to 1.12.1 per the repo's dependency-widening convention.

* no-mistakes(review): Add behavioral tests for 4 new BLE readers; fix stale AGENTS.md protocol-floor note

* no-mistakes(document): Fix AGENTS.md unwrapped-fields list; format new BLE reader test file

Author: Bre77

AGENTS.md

@@ -484,6 +484,10 @@ Available BLE state readers:
 - `gui_settings()`
 - `parked_accessory_state()`
 - `legacy_vehicle_state()` (CarServer's `GetVehicleState` - a different message from `vehicle_state()` above)
+- `vehicle_config()`
+- `soh_state()`
+- `vehicle_detail_state()`
+- `display_state()`
 - `alert_state()`
 - `light_show_state()`
 - `suspension_state()`

docs/bluetooth_vehicles.md

@@ -4,7 +4,7 @@ requires = ["setuptools>=77.0"]
 
 [project]
 name = "tesla_fleet_api"
-version = "1.12.0"
+version = "1.12.1"
 license = "Apache-2.0"
 description = "Tesla Fleet API library for Python"
 readme = "README.md"
@@ -22,7 +22,7 @@ dependencies = [
     "aiolimiter>=1",
     "cryptography>=43",
     "protobuf>=6.32.0",
-    "tesla-protocol>=0.5.0",
+    "tesla-protocol>=1.4.0",
     "bleak>=0.22",
     "bleak-retry-connector>=3.9",
 ]

pyproject.toml

@@ -1,7 +1,7 @@
 """Tesla Fleet API"""
 
 __author__ = "hello@teslemetry.com"
-__version__ = "1.12.0"
+__version__ = "1.12.1"
 
 from tesla_fleet_api.const import Region, is_valid_region
 from tesla_fleet_api.funnel import (

tesla_fleet_api/__init__.py

@@ -44,6 +44,7 @@
     GetChildPresenceDetectionState,
     GetClimateState,
     GetClosuresState,
+    GetDisplayState,
     GetDriveState,
     GetGuiSettings,
     GetLightShowState,
@@ -53,10 +54,13 @@
     GetParentalControlsState,
     GetParkedAccessoryState,
     GetPreconditioningScheduleState,
+    GetSohState,
     GetSoftwareUpdateState,
     GetSuspensionState,
     GetTirePressureState,
+    GetVehicleConfig,
     GetVehicleData,
+    GetVehicleDetailState,
     GetVehicleState,
     VehicleAction,
 )
@@ -89,6 +93,7 @@
     ChildPresenceDetectionState,
     ClimateState,
     ClosuresState,
+    DisplayState,
     DriveState,
     GuiSettings,
     LightShowState,
@@ -98,10 +103,13 @@
     ParentalControlsState,
     ParkedAccessoryState,
     PreconditioningScheduleState,
+    SohState,
     SoftwareUpdateState,
     SuspensionState,
     TirePressureState,
+    VehicleConfig,
     VehicleData,
+    VehicleDetailState,
     VehicleState,
 )
 
@@ -1946,6 +1954,58 @@ async def legacy_vehicle_state(self) -> VehicleState:
             )
         ).legacy_vehicle_state
 
+    async def vehicle_config(self) -> VehicleConfig:
+        """Return the vehicle's configuration/options state over BLE."""
+        return (
+            await self._getInfotainment(
+                Action(
+                    vehicleAction=VehicleAction(
+                        getVehicleData=GetVehicleData(
+                            getVehicleConfig=GetVehicleConfig()
+                        )
+                    )
+                )
+            )
+        ).vehicle_config
+
+    async def soh_state(self) -> SohState:
+        """Return the current state-of-health data over BLE."""
+        return (
+            await self._getInfotainment(
+                Action(
+                    vehicleAction=VehicleAction(
+                        getVehicleData=GetVehicleData(getSohState=GetSohState())
+                    )
+                )
+            )
+        ).soh_state
+
+    async def vehicle_detail_state(self) -> VehicleDetailState:
+        """Return additional vehicle detail state over BLE."""
+        return (
+            await self._getInfotainment(
+                Action(
+                    vehicleAction=VehicleAction(
+                        getVehicleData=GetVehicleData(
+                            getVehicleDetailState=GetVehicleDetailState()
+                        )
+                    )
+                )
+            )
+        ).vehicle_detail_state
+
+    async def display_state(self) -> DisplayState:
+        """Return the current display state over BLE."""
+        return (
+            await self._getInfotainment(
+                Action(
+                    vehicleAction=VehicleAction(
+                        getVehicleData=GetVehicleData(getDisplayState=GetDisplayState())
+                    )
+                )
+            )
+        ).display_state
+
     async def alert_state(self) -> AlertState:
         """Return the current active vehicle alerts over BLE."""
         return (

tesla_fleet_api/tesla/vehicle/bluetooth.py

@@ -1444,7 +1444,7 @@ async def navigation_sc_request(self, order: int) -> dict[str, Any]:
             Action(
                 vehicleAction=VehicleAction(
                     navigationSuperchargerRequest=NavigationSuperchargerRequest(
-                        order=order
+                        remote_nav_trip_order=order  # pyright: ignore[reportArgumentType]
                     )
                 )
             )

tesla_fleet_api/tesla/vehicle/commands.py

@@ -1,21 +1,26 @@
-"""Regression tests for the 7 new BLE vehicle-data sub-state readers.
+"""Regression tests for the 11 new BLE vehicle-data sub-state readers.
 
 Completes GetVehicleData coverage alongside the existing 12 readers
 (``test_ble_mocked_state_readers.py``): gui_settings, parked_accessory_state,
 legacy_vehicle_state, alert_state, light_show_state, suspension_state,
-child_presence_detection_state.
+child_presence_detection_state, vehicle_config, soh_state,
+vehicle_detail_state, display_state.
 """
 
 from tesla_fleet_api.const import BluetoothVehicleData
 from tesla_protocol.command.car_server_pb2 import Action
 from tesla_protocol.command.vehicle_pb2 import (
     AlertState,
     ChildPresenceDetectionState,
+    DisplayState,
     GuiSettings,
     LightShowState,
     ParkedAccessoryState,
+    SohState,
     SuspensionState,
+    VehicleConfig,
     VehicleData,
+    VehicleDetailState,
     VehicleState,
 )
 
@@ -108,6 +113,54 @@ async def test_child_presence_detection_state(self) -> None:
         self.assertTrue(result.cpd_hvac_active)
 
 
+class VehicleConfigTests(MockedBleTransportTestCase):
+    async def test_vehicle_config(self) -> None:
+        vehicle, send = self.make_vehicle()
+        send.return_value = infotainment_vehicle_data_reply(
+            VehicleData(vehicle_config=VehicleConfig(has_air_suspension=True))
+        )
+        result = await vehicle.vehicle_config()
+        self.assertIsInstance(result, VehicleConfig)
+        self.assertTrue(result.has_air_suspension)
+
+
+class SohStateTests(MockedBleTransportTestCase):
+    async def test_soh_state(self) -> None:
+        vehicle, send = self.make_vehicle()
+        send.return_value = infotainment_vehicle_data_reply(
+            VehicleData(
+                soh_state=SohState(soh_result=SohState.SohResult(soh_calibrated=True))
+            )
+        )
+        result = await vehicle.soh_state()
+        self.assertIsInstance(result, SohState)
+        self.assertTrue(result.soh_result.soh_calibrated)
+
+
+class VehicleDetailStateTests(MockedBleTransportTestCase):
+    async def test_vehicle_detail_state(self) -> None:
+        vehicle, send = self.make_vehicle()
+        send.return_value = infotainment_vehicle_data_reply(
+            VehicleData(
+                vehicle_detail_state=VehicleDetailState(car_version="2025.14.3")
+            )
+        )
+        result = await vehicle.vehicle_detail_state()
+        self.assertIsInstance(result, VehicleDetailState)
+        self.assertEqual(result.car_version, "2025.14.3")
+
+
+class DisplayStateTests(MockedBleTransportTestCase):
+    async def test_display_state(self) -> None:
+        vehicle, send = self.make_vehicle()
+        send.return_value = infotainment_vehicle_data_reply(
+            VehicleData(display_state=DisplayState(displayBrightnessAuto=True))
+        )
+        result = await vehicle.display_state()
+        self.assertIsInstance(result, DisplayState)
+        self.assertTrue(result.displayBrightnessAuto)
+
+
 class VehicleDataDispatchNewEndpointsTests(MockedBleTransportTestCase):
     """The 7 new sub-states must wire into ``vehicle_data()``'s endpoints dispatch."""
 

tests/test_ble_mocked_state_readers_new.py

@@ -90,7 +90,9 @@ async def test_sends_supercharger_order(self) -> None:
 
         self.assertEqual(result, {"response": {"result": True, "reason": ""}})
         vehicle_action = _decode_vehicle_action(vehicle, send.await_args.args[0])
-        self.assertEqual(vehicle_action.navigationSuperchargerRequest.order, 1)
+        self.assertEqual(
+            vehicle_action.navigationSuperchargerRequest.remote_nav_trip_order, 1
+        )
 
 
 class NavigationWaypointsRequestTests(MockedBleTransportTestCase):

tests/test_ble_nav_misc_commands.py

@@ -54,7 +54,14 @@
     ALTERNATE_PATH_VEHICLE_ACTION_FIELDS | STREAMING_SUBSCRIPTION_VEHICLE_ACTION_FIELDS
 )
 
-KNOWN_UNWRAPPED_GET_VEHICLE_DATA_FIELDS: frozenset[str] = frozenset()
+# A second, newer GetVehicleData request field alongside the pre-existing
+# getVehicleState, both requesting an (as yet unverified live) legacy vehicle
+# state - already wrapped as legacy_vehicle_state() via getVehicleState.
+# Needs live confirmation of how it differs before wrapping a second method
+# for what may be the same reply data.
+KNOWN_UNWRAPPED_GET_VEHICLE_DATA_FIELDS: frozenset[str] = frozenset(
+    {"getLegacyVehicleState"}
+)
 
 
 def _vehicle_action_fields():