Initial commit: FranklinWH AGATE client library reverse engineered from Family Energy app

- Reverse engineered network I/O stack for AGATE device
- Bluetooth LE and Wi-Fi onboard communication support
- Discovered operations: queryAgateInfo, queryDeviceInfoHttp, queryModesByHttp, queryConnectWifi, connectViaBluetooth, startBluetoothHeartbeat
- Cloud API endpoints identified: e-api.franklinwh.com, energy.franklinwh.com, hes-gateway
- Python library structure with client, bluetooth, wifi, api modules
- Documentation for reverse engineering findings

franklinwh_agate_client/api.py

@@ -0,0 +1,22 @@
+"""
+API Client for FranklinWH cloud services.
+"""
+
+class ApiClient:
+    """Client for FranklinWH cloud API endpoints."""
+    
+    BASE_URLS = {
+        "api": "https://e-api.franklinwh.com/api/appapi",
+        "energy": "https://energy.franklinwh.com/api-energy/deviceGroup/electric",
+        "gateway": "https://energy.franklinwh.com/hes-gateway",
+        "dev": "https://dev.franklinwh.com/hes-gateway",
+        "uat": "https://uat.franklinwh.com/api-vpp-portal",
+        "test": "https://test.franklinwh.com",
+    }
+    
+    def __init__(self, base_url=None):
+        self.base_url = base_url or self.BASE_URLS["api"]
+    
+    def query_device_info(self, device_id):
+        """Query device information from cloud API."""
+        pass