chore: browser websocket connection (#3092)

Author: nitpicker55555

camel/toolkits/hybrid_browser_toolkit/ws_wrapper.py

@@ -264,9 +264,20 @@ async def start(self):
                     self.ts_log_file.close()
                 self.ts_log_file = None
             self.process = None
-            raise RuntimeError(
-                "WebSocket server failed to start within timeout"
-            )
+
+            error_msg = "WebSocket server failed to start within timeout"
+            import psutil
+
+            mem = psutil.virtual_memory()
+            if mem.available < 1024**3:  # Less than 1GB available
+                error_msg = (
+                    f"WebSocket server failed to start"
+                    f"(likely due to insufficient memory). "
+                    f"Available memory: {mem.available / 1024**3:.2f}GB "
+                    f"({mem.percent}% used)"
+                )
+
+            raise RuntimeError(error_msg)
 
         # Connect to the WebSocket server
         try:
@@ -291,9 +302,21 @@ async def start(self):
                     self.ts_log_file.close()
                 self.ts_log_file = None
             self.process = None
-            raise RuntimeError(
-                f"Failed to connect to WebSocket server: {e}"
-            ) from e
+
+            error_msg = f"Failed to connect to WebSocket server: {e}"
+            import psutil
+
+            mem = psutil.virtual_memory()
+            if mem.available < 1024**3:  # Less than 1GB available
+                error_msg = (
+                    f"Failed to connect to WebSocket server"
+                    f"(likely due to insufficient memory). "
+                    f"Available memory: {mem.available / 1024**3:.2f}GB"
+                    f"({mem.percent}% used). "
+                    f"Original error: {e}"
+                )
+
+            raise RuntimeError(error_msg) from e
 
         # Start the background receiver task
         self._receive_task = asyncio.create_task(self._receive_loop())
@@ -443,7 +466,19 @@ async def _receive_loop(self):
     async def _ensure_connection(self) -> None:
         """Ensure WebSocket connection is alive."""
         if not self.websocket:
-            raise RuntimeError("WebSocket not connected")
+            error_msg = "WebSocket not connected"
+            import psutil
+
+            mem = psutil.virtual_memory()
+            if mem.available < 1024**3:  # Less than 1GB available
+                error_msg = (
+                    f"WebSocket not connected "
+                    f"(likely due to insufficient memory). "
+                    f"Available memory: {mem.available / 1024**3:.2f}GB "
+                    f"({mem.percent}% used)"
+                )
+
+            raise RuntimeError(error_msg)
 
         # Check if connection is still alive
         try:
@@ -453,7 +488,20 @@ async def _ensure_connection(self) -> None:
         except Exception as e:
             logger.warning(f"WebSocket ping failed: {e}")
             self.websocket = None
-            raise RuntimeError("WebSocket connection lost")
+
+            error_msg = "WebSocket connection lost"
+            import psutil
+
+            mem = psutil.virtual_memory()
+            if mem.available < 1024**3:  # Less than 1GB available
+                error_msg = (
+                    f"WebSocket connection lost "
+                    f"(likely due to insufficient memory). "
+                    f"Available memory: {mem.available / 1024**3:.2f}GB "
+                    f"({mem.percent}% used)"
+                )
+
+            raise RuntimeError(error_msg)
 
     async def _send_command(
         self, command: str, params: Dict[str, Any]