From a186d26885bf8f55a4b1d967f7ed57c896f45379 Mon Sep 17 00:00:00 2001
From: firstmate crewmate <crewmate@firstmate.local>
Date: Thu, 23 Jul 2026 08:22:38 +1000
Subject: [PATCH] feat(vehicle): add connectivity/diagnostics signed commands

Wraps three previously-unimplemented VehicleAction fields:
bluetooth_classic_pairing_request, bandwidth_test, and fetch_keys_info.
Follows the existing Commands wrapper pattern, so both Fleet-signed
and BLE transports get these for free.
---
 tesla_fleet_api/tesla/vehicle/commands.py     | 37 +++++++++++++
 ...t_ble_connectivity_diagnostics_commands.py | 54 +++++++++++++++++++
 2 files changed, 91 insertions(+)
 create mode 100644 tests/test_ble_connectivity_diagnostics_commands.py

diff --git a/tesla_fleet_api/tesla/vehicle/commands.py b/tesla_fleet_api/tesla/vehicle/commands.py
index 390a0cf..4973c1a 100644
--- a/tesla_fleet_api/tesla/vehicle/commands.py
+++ b/tesla_fleet_api/tesla/vehicle/commands.py
@@ -180,6 +180,9 @@
     TeslaAuthResponseAction,
     SetupCloudProfileWithLocalProfileUuidAction,
     GetLocalProfilesForVaultUuidAction,
+    BluetoothClassicPairingRequest,
+    BandwidthTest,
+    FetchKeysInfoAction,
 )
 from google.protobuf.timestamp_pb2 import Timestamp
 from tesla_protocol.command.vehicle_pb2 import (
@@ -2515,3 +2518,37 @@ async def get_local_profiles_for_vault_uuid(
             ),
             mutating=False,
         )
+
+    async def bluetooth_classic_pairing_request(
+        self, name: str, mac_address: bytes
+    ) -> dict[str, Any]:
+        """Requests Bluetooth Classic (not BLE) pairing with a phone for calls/audio."""
+        return await self._sendInfotainment(
+            Action(
+                vehicleAction=VehicleAction(
+                    bluetoothClassicPairingRequest=BluetoothClassicPairingRequest(
+                        utf8_name=name,
+                        mac_address=mac_address,
+                    )
+                )
+            )
+        )
+
+    async def bandwidth_test(self, requested_size: int) -> dict[str, Any]:
+        """Runs a diagnostic bandwidth test of the given size in bytes."""
+        return await self._sendInfotainment(
+            Action(
+                vehicleAction=VehicleAction(
+                    bandwidthTest=BandwidthTest(requested_size=requested_size)
+                )
+            )
+        )
+
+    async def fetch_keys_info(self) -> dict[str, Any]:
+        """Gets information about keys paired with the vehicle."""
+        return await self._sendInfotainment(
+            Action(
+                vehicleAction=VehicleAction(fetchKeysInfoAction=FetchKeysInfoAction())
+            ),
+            mutating=False,
+        )
diff --git a/tests/test_ble_connectivity_diagnostics_commands.py b/tests/test_ble_connectivity_diagnostics_commands.py
new file mode 100644
index 0000000..025217d
--- /dev/null
+++ b/tests/test_ble_connectivity_diagnostics_commands.py
@@ -0,0 +1,54 @@
+"""Connectivity/diagnostics commands over the mocked BLE transport."""
+
+from tesla_protocol.command.car_server_pb2 import Action
+from tesla_protocol.command.universal_message_pb2 import Domain
+
+from ble_mocked_transport import (
+    MockedBleTransportTestCase,
+    decrypt_sent_command,
+    infotainment_action_ok_reply,
+)
+
+
+def _decode_vehicle_action(vehicle, sent_msg):
+    plaintext = decrypt_sent_command(vehicle, sent_msg)
+    action = Action.FromString(plaintext)
+    assert sent_msg.to_destination.domain == Domain.DOMAIN_INFOTAINMENT
+    return action.vehicleAction
+
+
+class BluetoothClassicPairingRequestTests(MockedBleTransportTestCase):
+    async def test_sends_name_and_mac_address(self) -> None:
+        vehicle, send = self.make_vehicle()
+        send.return_value = infotainment_action_ok_reply()
+
+        await vehicle.bluetooth_classic_pairing_request(
+            "My Phone", b"\x00\x11\x22\x33\x44\x55"
+        )
+
+        vehicle_action = _decode_vehicle_action(vehicle, send.await_args.args[0])
+        req = vehicle_action.bluetoothClassicPairingRequest
+        self.assertEqual(req.utf8_name, "My Phone")
+        self.assertEqual(req.mac_address, b"\x00\x11\x22\x33\x44\x55")
+
+
+class BandwidthTestTests(MockedBleTransportTestCase):
+    async def test_sends_requested_size(self) -> None:
+        vehicle, send = self.make_vehicle()
+        send.return_value = infotainment_action_ok_reply()
+
+        await vehicle.bandwidth_test(1024)
+
+        vehicle_action = _decode_vehicle_action(vehicle, send.await_args.args[0])
+        self.assertEqual(vehicle_action.bandwidthTest.requested_size, 1024)
+
+
+class FetchKeysInfoTests(MockedBleTransportTestCase):
+    async def test_sends_fetch_keys_info_action(self) -> None:
+        vehicle, send = self.make_vehicle()
+        send.return_value = infotainment_action_ok_reply()
+
+        await vehicle.fetch_keys_info()
+
+        vehicle_action = _decode_vehicle_action(vehicle, send.await_args.args[0])
+        self.assertTrue(vehicle_action.HasField("fetchKeysInfoAction"))